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l. INTRODUCTION. 


CP/M is a monitor control program for microcomputer system development 
which uses IBM-campatible flexible disks for backup storage, Using a camputer 
mainframe based upon Intel's 88848 microcomputer, CP/M provides a general 
environment for program construction, storage, and editing, along with 
assembly and program check-out facilities, An important feature of CP/M is 
that it can be easily altered to execute with any camputer configuration which 
uses an Intel 8888 (or Zilog 2-80) Central Processing Unit, and nas at least 
AK bytes of main memory with up to four IBM-compatible diskette drives. A 
detailed discussion of the modifications required for any particular hardware 
environment is given in the Digital Research document entitled "CP/M System 
Alteration Guide," Although the standard Digital Research version operates on 
a single-density Intel MIS 880, several different hardware manufacturers 
support their own input-output drivers for CP/M. 


The CP/M monitor provides rapid access to programs through a 
comprehensive file management package. The file subsystem supports a named 
file structure, allowing dynamic allocation of file space as weli as 
sequential and randam file access. Usina this file system, a large number of 
distinct programs can be stored in both source and machine executable form. 


CP/M also supports a powerful context editor, Intel-compatible assembler, 
and debugger subsystems, Optional software includes a powerful 
Intel-campatible macro assembler, symbolic debugger, along with various 
high-level languages, When coupled with CP/M's Console Command Processor, the 
resulting facilities equal or excel similar large camputer facilities. 


` CP/M is logically divided into several distinct parts: 


BIOS Basic I/O System (hardware dependent) 
BDOS Basic Disk Operating System 

CCP Console Command Processor 

TPA Transient Program Area 


The BIOS provides the primitive operations necessary to access the 
diskette drives and to interface standard peripherals (teletype, CRT, Paper 
Tape Reader/Punch, and user-defined peripherals), and can be tailored by the 
user for any particular hardware environment by "patching" this portion of 
. Cp/M. The BDOS provides disk management by controlling one or more disk 
drives containing independent file directories, The BDOS implements disk 
allocation strategies which provide fully dynamic file construction while 
minimizing head movement across the disk during access, Any particular file 
may contain any number of records, not exceeding the size of any single disk. 
In a standard CP/M system, each disk can contain up to 64 distinct files. The 


BDOS has entry points which include the following primitive operations which 
can be programmatically accessed: 


SEARCH Look for a particular disk file by name. 
OPEN Open a file for further cmerations, 
CLOSE Close a file after crocessing. 
RENAME Change the name of a particular file. 

m, READ Read a record from a particular file. 
WRITE Write a record onto the disk. 
SELECT Select a particular disk drive for further 

Operations, 


The CCP provides symbolic interface between the user's console and the 
remainder of the CP/M system, The CCP reads the console device and processes 
commands which include listing the file directory, printing the contents of 
files, and controlling the operation of transient programs, such as 
assemblers, editors, and debuggers, The standard cammands which are available 
in the CCP are listed in a following section. 


The last segment of CP/M is the area called the Transient Program Area 
(TPÀ), The TPA holds programs which are loaded from the disk under cammand of 
the CCP, During program editing, for example, the TPA holds the CP/M text 
editor machine code and data areas, Similarly, programs created under CP/M 
can be checked out by loading and executing these programs in the TPA, 


It should be mentioned that amy or all of the CP/M component subsystems 
can be "overlayed" by an executing program, That is, once a user's program is 
loaded into the TPA, the CCP, BDOS, and BIOS areas can be used as the 
program's data area, A “bootstrap” loader is programmatically accessible 
whenever the BIOS portion is not overlayed; thus, the user program need only 
. branch to the bootstrap loader at the end of execution, and the camplete CP/M 
monitor is reloaded fram disk, 


It should be reiterated that the CP/M operating system is partitioned 
into distinct modules, including the BIOS portion which defines the hardware 
envirorment in which CP/M is executing. Thus, the standard system can be 
easily modified to any non-standard environment by changing the peripheral 
drivers to handle the custom system. 


2. | FUNCTIONAL DESCRIPTION OF CP/M. 


The user interacts with CP/M primarily through tne CCP, which reads and 
interprets conmands entered through the console. In general, the CCP 
addresses one of several disks which are online (the standard system addresses 
up to four different disk drives), These diss drives are labelled A, B, C, 
and D. A disk is "logged in" if the CCP is currently addressing the disk. In 
order to clearly indicate which disk is the currently logged disk, the CCP 
always prompts the Operator with the disk name followed by the symbol ">" 
indicating that the CCP is ready for another canmand, Upon initial start up, 
the CP/M system is brought in fram disk A, and the CCP displays the message 


xxK CP/M VER m.m 


where xx is the memory size (in kilobytes) which this CP/M system manages, and 
m.m is the CP/M version number, All CP/M systems are initially set to operate 
in a 16K memory space, but can be easily reconfigured to fit any memory size 
on the host system (see the MOVCPM transient command). Following system 
signon, CP/M automatically logs in disk A, prampts the user with the symbol 
"A»" (indicating that CP/M is currently addressing disk "A"), and waits for a 
command. The canmands are implemented at two levels: built-in cammards and 
transient canmands, 


2.1, GENERAL COMMAND STRUCTURE, 
Built-in canmands are a part of the CCP program itself, while transient 


commands are loaded into the TPA fron disk amd executed. The built-in 
commands are 


ERA Erase specified files. 

DIR List file names in the directory. 

REN Rename the specified file. 

SAVE Save memory contents in a file, 

TYPE Type the contents of a file on the logged disk. 


Nearly all of the cammands reference a particular file or group of files, The 
form of a file reference is specified below. 


2.2, FILE REFERENCES, 


A file reference identifies a particular file or group of files on a 
particular disk attached to CP/M. These file references can be either 
“unambiguous” (ufn) Or "ambiguous" (afn). An unambiguous file reference 
uniquely identifies a single file, while an ambiguous file reference may be 


` satisfied by a number of different files. 


Pile references consist of two parts: the primary name and the secondary 
name, Although the secondary name is optional, it usually is generic; that 


is, the secondary name "ASM," for example, is used to denote that the file is 


an assembly language source file, while the primary name distinguishes each 
particular source file. The two names are separated by a "." as shown below: 


DDPPDPPD, SSS 


«here ppopDppop represents the rrimary name of eight characters or less, and 
38s is the secondary name of no more than three characters, As mentioned 


above, the name 


OPPPPUPD 


is also allowed ard is equivalent to a secondary name consisting of three 
blanks, The characters used in specifying an unambiguous file reference 
cannot contain any of tbe special characters | 


oM wow pop AE (BON [ ] 
while all alphanumerics and renaining special characters are al lowed. 
An ambiquous file reference is used for directory search and pattern 


matching. The form of an ambiguous file reference is similar to an 
unambiguous reference, except the symbol "?" may be interspersed throughout 


. the primary and secondary names, In various commands throughout CP/M, the "?" 


symbol matches any character of a file name in the "?" position, Thus, the 
wmbiguous reference 
X?2.C?M 
is satisfied by the unambiguous file names 
XYZ . COM 
and 
X 32 , CAM 


Note that the ambiguous reference 


x » 


is equivalent to the ambiguous file reference 
2?????27? ere 


while 


and 


are abbreviations for 


| PPEppppp. ??? 
and 
2722????.5S8S 
respectively. AS an example, 
DIR. *,* 


is interpreted by the CCP as a cammand to list the names of all disk files in 
the directory, while 


DIR X.Y 
searches only for a file by the name X.Y Similarly, the command 
DIR X?Y.C?M 


causes a search for all (unambiguous) file names on the disk which satisfy 
this ambiguous reference. 


The followirg file names are valid unambiquous file references: 
X XYZ GAMMA 


X.Y XYZ . COM GAMMA, 


As an added convenience, the programmer can generally specify the disk 
drive name along with the file name. In this case, the drive name is given as 
a letter A through 2 followed by a colon (:). The specified drive is then 
“logged in" before the file operation occurs, Thus, the following are valid 
file names with disk name pr efixes: 


A:X.Y B:XYZ C:GAMMA 
Z :XYZ ¿COM B:X,A?M C:* ASM 
It should also be noted that all alphabetic lower case letters in file 


and drive names are always translated to upper case when they are processed Dy 
the CCP. 


3, SWITCHING DISKS, 


The operator can switch the currently logged disk by typing the disk 

- drive name (A, B, C, or D) followed by a colon (:) when the CCP is waiting for 

console input. Thus, the sequence of prompts and commands shown below might 
occur after the CP/M system is loaded fram disk A: 


16K CP/M VER 1,4 


A>DIR List all files on disk A, 
? SAMPLE ASM 

SAMPLE PRN 

ADB: Switch to disk B. 

B»DIR *.ASM List all "ASM" files on B. 

DUMP ASM 

FILES ASM 

BA: Switch back to A. 


4, THE FORM CF BUILT-IN COMMANDS. 


The file ard device reference forms oescriped above can now be used to 
fully specify the structure of the built-in cammands. In the description 
below, assume the following abbreviations: 


ufn - unambiquous file reference 
afn - ambiguous file reference 
SE ~ carriage return 


Further, recall that the CCP always translates lower case characters to upper 
case characters internally. Thus, lower case alphabetics are treated as if 
they are upper case in cammard names and file references, 


4.1 ERA afn cr 


The ERA (erase) command removes files from the currently logged-in disk 
(i.e., the disk name currently prompted by CP/M preceding the ^5"). The files 
which are erased are those which satisfy the ambiguous file reference afn. 
The following examples illustrate the use of ERA: 


ERA X.Y The file named X.Y on the currently logged disk 
is removed fram the disk directory, and the space 
is returned. 


ERA X,* All files with primary name X are removed fram 
the current disk, 


ERA *.ASM All files with secondary name ASM are removed 
fram the current disk, 


ERA X?Y.C?M All files on the current disk which satisfy tne 
ambiguous reference X?Y.C?M are deleted, 


ERA *,* Erase all files on the current disk (in this case 
the CCP prampts the console with the message 
"ALL FILES (Y/N)?" 
which requires a Y response before files are 
actually removed). 


ERA B:*, PRN All files on drive B which satisfy the ambiguous 
reference ????????,PRN are deleted, independently 
of the currently logged disk. 


4.2, DIR afn cr 
The DIR (directory) cammand causes the names of all files which satisfy 
the ambiguous file name afn to be listed at the console device, As a special 
case, the conmand 
DIR 


lists the files on the currently logged disk (the command "DIR" is equivalent 
to the canmand "DIR *,*"). Valid DIR commands are shown below, 


DIR X.Y 

DIR X?2,C?M 

DIR Feat 

Similar to other CCP cammands, the afn can be preceded by a drive name, 

The following DIR commands cause the selected drive to be addressed before the 
directory search takes place. 

DIR B: 

DIR B:X.Y 

DIR B:*,A?M 


If no files can be found on the selected diskette which satisfy the 
directory request, then the message "NOT FOUND" is typed at the console, 


à 4,3. REN ufnl=ufn2 cr 


The REN (rename) command allows the user to change the names of files on 
disk. The file satisfying ufn2 is changed to ufnl, The currently logged disk 
is assumed to contain the file to rename (ufnl). The CCP also allows the user 
to type a left-directed arrow instead of the equal sign, if the user s console 
supports this graphic character. Examples of the REN cammand are 


REN X, Y2Q.R The file Q.R is changed to X.Y, 
REN XYZ,COM-XYZ ¿XXX The file XYZ,XXX is charged to XYZ,COM, 


The operator can precede either ufnl or ufn2 (or both) by an optional 
drive address. Given that ufnl is preceded by a drive name, then ufn2 is 
assumed to exist on the same drive as ufnl, Similarly, if ufn2 is preceded by 
a drive name, then ufnl is assumed to reside on that drive as well. If both 
Jfnl and ufn2 are preceded by drive names, then the same drive must be 


TYPE X.PLM 


TYPE XXX 


The TYPE cammand expands tabs (clt-1 characters), assuming tab positions 
ire set at every eighth colum, The ufn can also reference a drive name as 


shown below, 
TYPE B:X.PRN The file X.PRN fram drive B is displayed. 
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sn LINE EDITING AND OUTPUT CONTROL, 


The CCP allows certain line editing functions while typing cammand lines, 


rubout 


ctl-U 
ctl-X 


Ctl-R 


ctl-E 


cti 


cti-2 


Delete and echo the last character typed at the 
console, 


Delete the entire line typed at the console. 
(Same as ctl-U) 


Retype current cammand line: types a "Clean line" fol- 
lowing character deletion with rubouts. 


Physical end of line: carriage 1s returned, but line 
is not sent until the carriage return key is depressed. 


CP/M system reboot (warm start) 


end input fram the console (used in PIP and ED). 


The control functions ctl-P ard ctl-S affect console output as shown below, 


ctl-P 


ctl-S 


Copy all subsequent console output to the currently 
assigned list device (see the STAT command). Output 


is sent to both the list device and the console device 
until the next ctl-P is typed. 


Stop the console output temporarily. Program execution 
and output continue when the next character is typed 
at the console (e.g., another ctl-S), This feature is 
used to stop output on high speed consoles, such as 
CRI s, in order to view a segment of output before con- 
tinuing. 


Note that the ctl-key sequences shown above are obtained by depressing the 


control ard letter 


keys simultaneously. Further, CCP command lines can 


generally be up to 255 characters in length; they are not acted upon until the 
carriage return key is typed. 


il 


6. | TRANSIENT COMMANEIS, 


Transient cammands are loaded fram the currently logged disk and executed 
in the TPA, The transient cammands defined for execution under the CCP are 
shown below, Additional functions can easily be defined by the user (see the 

— LOAD canmand definition). 


STAT List the number of bytes of storage remaining on the 
currently logged disk, provide statistical information 
about particular files, and display or alter device 


assignment. 
a | 
ASM Load the CP/M assembler and assemble the specified 
program fram disk, 
LOAD Load the file in Intel "hex" machine code format and 
produce a file in machine executable form which can be 
loaded into the TPA (this loaded program becomes a 
new camnand under the CCP). 
DDT Load the CP/M debugger into TPA and start execution, 
PIP Load the Peripheral Interchange Program for subsequent 
disk file and peripheral transfer operations, 
ED Load and execute the CP/M text editor program, 
SYSGEN Create a new CP/M system diskette, 
` SUBMIT Submit a file of commands for batch processing. 
DUMP Dump the contents of a file in hex. 
MOVCPM Regenerate the CP/M system for a partícular memory 
size. 


Transient cammands are specified in the same manner as built-in commands, and 
additional cammands can be easily defined by the user. As an added 
corvenience, the transient camand can be preceded by a drive name, which 
causes the transient to be loaded fram the specified drive into the TPA for 
execution, Thus, the command 


B:STAT 
causes CP/M to temporarily "log in" drive B for the source of the STAT 


transient, and then return to the original logged disk for subsequent 
processing. | 
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The basic transient cammands are listed in detail below, 
6.1. STAT cr 


The STAT canmand provides general statistical information about file 
storage and device assignment, It is initiated by typing one of the following 
forms: 


STAT cr 
STAT "cammand line" cr 


Special forms of the "cammand line" allow the current device assignment to be 
examined and altered as well, The various cammand lines which can be 
specified are shown below, with an explanation of each form shown to the 
right. 


STAT cr If the user types an empty cammand line, the STAT 
transient calculates the storage remaining on all 
active drives, and prints a message 


x: R/W, SPACE: nnnK 
or 
x: R/O, SPACE: nnnK 


for each active drive x, where R/W indicates the 
drive may be read or written, and R/O indicates 
the drive is read only (a drive becomes R/O by 
explicitly setting it to read only, as shown 
below, or by inadvertantly changing diskettes 
without performing a warm start), The space 
remaining on the diskette in drive x is given 
in kilobytes by nnn. 


STAT x: Cr If a drive name is given, then the drive is 
selected before the storage is computed, Thus, 
the command "STAT B:" could be issued while 
logged into drive A, resulting in the message 


BYTES REMAINING ON B: nnnK 

STAT afn cr The command line can also specify a set of files 
to be scanned by STAT, The files which satisfy 
afn are listed in alphabetical order, with stor- 
age requirements for each file under the heading 


RECS BYTS EX D:FILENAME,TYP 
rrrr bbbK ee d: pppppppp.sss 


where rrrr is tbe number of 128-byte records 


L3 


allocated to the file, bbb is the number of kllo- 
bytes allocated to the file (bbbsrrrr*128/1024), 
ee is the number of 16K extensions (ee=bbb/16), 

d is the drive name containing the file (A...2), 
pppoppop is the (up to) eight-character primary 
file name, and sss is the (up to) three-character 
secondary name, After listing the individual 
files, the storage usage is summarized, 


STAT x:afn cr As a convenience, the drive name can be given 

ma ahead of the afn. In this case, the specified 
drive is first selected, and the form "STAT afn" 
is executed. 


STAT x:-R/O cr This form sets the drive qiven by x to read-oniy, 
which remains in effect until the next warm or 
cold start takes place, When a disk is read-only, 
the message 


BDOS ERR ON x: READ ONLY 


will appear if there is an attempt to write to 
the read-only disk x. CP/M waits until a key 

is depressed before performing an automatic warm 
start (at which time the disk becomes R/W). 


The STAT command also allows control over the physical to logical device 
| ssignment (see the IOBYTE function described in the manuals "CP/M Interface 
Guide" and "CP/M System Alteration Guide"). In general, there are four 
logical peripheral devices which are, at any particular instant, each assigned 
to one of several physical peripheral devices, The four Jogical devices are 
named: 


CON: The system console device (used by CCP 
for cammunication with the operator) 

RDR: The paper tape reader device 

PUN: The paper tape punch device 

LST: The output list device 


The actual devices attached to any particular computer system are driven 
by subroutines in the BIOS portion of CP/M, Thus, tbe logical RDR: device, 
for example, could actually be a high speed reader, Teletype reader, Or 
cassette tape. In order to allow some flexibility in device naming and 
assignment, several physical devices are defined, as shown below: 
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r a t TT Sm . — —— o =- 


TY: — Teletype device (slow speed console) 
CRI: Cathode ray tube device (high speed console) 


BAT: Batch processing (console is current RDR:, 
output goes to current LST: device) 


UCI: User-defined console 

PTR: Paper tape reader (high speed reader) 
URI: User-defined reader #i 

UR2: User-defined reader #2 

PTP: Paper tape punch (high speed punch) 
UPL: User-defined punch #1 

UP2: User-defined punch #2 

LPT: Line printer 

UL]: User-defined list device #1 


It must be emphasized that the physical device names may or may not 
actually correspond to devices which the names imply. That is, the PTP: 
device may be implemented as a cassette write operation, if the user wishes. 
The exact correspondence and driving subroutine is defined in the BIOS portion 
of CP/M. In the standard distribution version of CP/M, these devices 
correspond to their names on the MIS 880 development system, 


The possible logical to physical device assignments can be displayed by 
typing 
STAT VAL: Cr 


The STAT prints the possible values which can be taken on for each logical 
device: 


CON. = TTY: CRI: BAT: UC): 
ROR: = TTY: PPR: URI: UR2: 
PUN: = TTY: PIP: UPL: UP2: 
LST: = TTY: CRT: LPP: ULL: 


In each case, the logical device shown to the left can take any of the four 
physical assignments shown to the right on each line, The current logical to 
physical mapping is displayed by typing the camnand 


STAT TEV: Cr 
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which produces a listing of each logical device to the left, and the current 
corresponding physical device to the right, Por example, the list might 
appear as follows: 


CON: = CRT: 
ROR: = URI]: 
PUN: = PIP: 
LST: = TTY; 


The current logical to physical device assignment can be changed by typing a 
STAT command cf the form 


STAT idl = pdl, 1d2 = pd2 , ... , làn = pàn cr 
where idl through ldn are logical device names, and pil through pn are 
compatible physical device names (i.e., ldi and mi appear on the same line in 
the "VAL:" cammand shown above), The following are valid STAT commands which 
change the current logical to physical device assignments: 


STAT CON:zCRT: cr 
STAT PUN: s TTY:,LST:=LPT:, RDR:=TTY: cr 


6,2. ASM ufn cr 
The ASM cammard loads and executes the CP/M 8084 assembler. The ufn 
Specifies a source file containing assembly language statements where the 
secondary name is assumed to be ASM, and thus is not specified. The following 
ASM cammards are valid: 
ASM X 
ASM GAMMA 


The two-pass assembler is autamatically executed. If assembly errors occur 
during tbe second pass, the errors are printed at the console, 


The assembler produces a file 
X .PRN 


where x is the primary name specified in the ASM command. The PRN file 
contains a listirg of the source program (with imbedded tab characters 1f 


- present in the source program), along with the machine code generated for each 


Statement and diagnostic error messages, if any, The PRN file can be listed 
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at the console using the TYPE command, or sent to a peripheral device using 
PIP (see the PIP camnand structure below), Note also that the PRN file 
contains the original source program, augmented by miscellaneous assembly 
information in the leftmost 16 colums (program addresses amd hexadecimal 
machine code, for example). Thus, the PRN file can serve as a backup for the 
original source file: if the source file is accidently removed or destroyed, 
the PRN file can he edited (see the ED onerater’s guide) by removing the 
leftmost 16 characters of each line (this can be done by issuing a single 
editor "macro" canmand). The resulting file is identical to the original 
source file and can be renamed (REN) from PRN to ASM for subsequent editing 
and assembly, The file 


x .HEX 


is also produced which contains 8088 machine language in Intel "hex" format 
suitable for subsequent loading and execution (see the LOAD command). For 
complete details of CP/M's assembly language program, see the "CP/M Assembler 
Language (ASM) User's Guide," 


Similar to other transient commands, the source file for assembly can be 
taken from an a ternate disk by prefixing the assembly language file name by a 
disk drive name, Thus, the cammand 

ASM B:ALPHA cr 
loads the assembler fran the currently logged drive and operates upon the 
source program ALPHA.ASM on drive B. The HEX and PRN files are also placed on 
drive B in this case, 

6.3. LOAD ufn cr 

The LOAD cammand reads the file ufn, which is assumed to contain "hex" 
format machine code, amd produces a memory image file which can be 
subsequently executed. The file name ufn is assumed to be of the form 

X HEX 


and thus only the name x need be specified in the command. The LOAD command 
creates a file named 


x. COM 
which marks it as containing machine executable code, The file is actually 
loaded into memory and executed when the user types the file name x 
immediately after the prampting character “>” printed by the CCP, 
In general, the CCP reads the name x following the prampting character 


and looks for a built-in function name. If no function name is found, the CCP 
searches the system disk directory for a file by the name 
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X, COM 


If found, tne machine code is loaded into the TPA, and the program executes, 
Thus, tbe user need only LOAD a hex file once; it can be subsequently 
executed any number of times by simply typing the primary name, In this way, 
. the user can "invent" new commands in the CCP.  (Initialized disks contain the 
transient cammands as COM files, which can be deleted at the user's option.) 
The Operation can take place on an alternate drive if the file name is 
«prefixed by a drive name, Thus, 


LOAD B:BETA 


brings the LOAD program into the TPA from the currently logged disk and 
operates umon drive B after execution begins, 


It must be noted that the BETA.HEX file must contain valid Intel format 
hexadecimal machine code records (as produced by the ASM program, for example) 
which begin at 108H, the beginning of the TPA, Further, the addresses in the 
hex records must be in ascending order; gaps in unfilled memory regions are 
filled with zeroes by the LOAD cammand as the hex records are read, Thus, 
LOAD must be used only for creating CP/M standard "COM" files which operate in 
the TPÀ, Programs which occupy regions of memory other than the TPÀ can be 
loaded under DDT. 


6.4. PIP cr 


a e , i , : 
PIP is the CP/M Peripheral Interchange Program which implements the basic 

media conversion operations necessary to load, print, punch, copy, and cambine 

disk files. The PIP program is initiated by typing one of the following forms 


(1) PIP cr 
(2) PIP “canmand line" cr 


In both cases, PIP is loaded into the TPA and executed, In case (1), PIP 
reads cammand lines directly from the console, prompted with the "x" 
character, until an empty cammand line is typed (i,e., a single carriage 
return is issued by the operator). Each successive command line causes some 
media conversion to take place according to the rules shown below, Form (2) 
of the PIP command is equivalent to the first, except that the single command 
line given with the PIP cammand is automatically executed, and PIP terminates 
immediately with no further pranpting of the console for input command lines, 
The form of each cammand line is 


destination = sourceél, source#2, ... , Source#n cr 


where "destination" is the file or peripheral device to receive the data, and 
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"sourcetl, ..., urcen” represents a series of one or more files or devices 
which are copied fram left to right to the destination, 


When multiple files are given in the cammand line (i.e, n > 1), the 
individual files are assumed to contain ASCII characters, with an assumed CP/M 
end-of-file character (ctl-2) at the end of each file (see the O parameter to 
override this assumption}. The equal symbol (=) can be replaced by a 
left-oriented arrow, if vour console supports this ASCII character, to improve 
readability. Lower case ASCII alphabetics are internally translated to upper 
case to be consistent with CP/M file and device name conventions, Finally, 
the total camnand line length cannot exceed 255 characters (ctl-E can be used 
to force a physical carriage return for lines which exceed the console width). 


The destination and source elements can be unambiquous references to CP/M 
source files, with or without a preceding disk drive name, That is, any file 
can be referenced with a preceding drive name (A:, B:, C:, or D:) which 
defines the particular drive where the file may be obtained or stored, When 
the drive name is not included, the currently logged disk is assumed. 
Further, the destination file can also appear as one or more of the source 
files, in which case the source file is not altered until the entire 
concatenation is complete, If the destination file already exists, it is 
removed if the canmand line is properly formed (it is not removed if an error 
condition arises), The following cammand lines (with explanations to the 
right) are valid as input to PIP: 


X = Y cr Copy to file X from file Y, 
where X and Y are unambiauous 
file names; Y remains uncharged, 


X= Y 2 cr Concatenate files Y and 2 and 
copy to file X, with Y and Z 
unchanged, 

X ASM=Y,ASM,Z,ASM,FIN,ASM cr Create the file X.ASM fram the 
concatenation of the Y, Z, and 
FIN files with type ASM, 

NEW.ZOT = B:OLD,2AP cr Move a copy of OLD.ZAP fran drive 
B to the currently logged disk; 
name the file NEW.ZOT. 

B:A.U = B:B.V,A:C.W,D.X cr Concatenate file B.V from drive B 


with C.W from drive A and D,X. 
from the logged disk; create 
the file A.U on drive B. 


For more convenient use, PIP allows abbreviated commands for transferring 
files between disk drives. The abbreviated forms are 
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PIP x:=afn cr 

PIP x:=y:afn cr 
PIP vfn = y: cr 
PIP x:ufn s y: cr 


The first form copies all files from the currently logged disk which satisfy 
the afm to the same file names on drive x (x = A...2). The second form is 


"equivalent to the first, where the source for the copy is drive y (y = A... 


2), The third form is equivalent to the command "PIP ufn=y:ufn cr" which 
copies the file given by ufn fram drive y to the file ufn on drive x, The 
fourth forn is equivalent to the third, where the source disk is explicitly 
given by y. 


Note that the source and destination disks must be different in all of 
these cases, If an afm is specified, PIP lists each ufn which satisfies the 
afm as it is beim copied. If a file exists by the same name as the 
destination file, it is removed upon successful campletion of the copy, and 
replaced by the copied file, 


The followirg PIP cammands give examples of valid disk-to-disk copy 
operations: 


B:=* COM cr Copy all files which have the 
secondary name "COM" to drive B 
from the current drive, 


A:=B:2AP,* cr Copy all files which have the 
primary name "ZAP" to drive A 
fram drive B. 


ZAP,ASM=B: Cr Equivalent to ZAP.ASMzB:2AP,.ASM 
B:2O0T, COM=A: cr Equivalent to B:Z20T,COM=A : ZOT, COM 
B:=GAMMA, BAS cr Same as B:GAMMA, BAS=GAMMA, BAS 
B:=A:GAMMA,BAS cr Same as B:GAMMA, BASzA:GAMMA,BAS 


PIP also allows reference to ohysical and logical devices which are 
. attached to the CP/M system, The device names are the same as given under the 
STAT cammand, along with a number of specially named devices, The logical 
devices given in the STAT cammand are 

CON: (console), RDR: (reader), PUN: (punch), and LST: (list) 


while the physical devices are 
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TTY: (console, reader, punch, or list) 

CRT: (console, or list), UCl: (console) 
PTR: (reader), UR]: (reader), uHZ: (reader) 
PTP: (punch), UPl: (punch), UP2: (punch) 

LPT: (list),  ULl: (list) 


(Note that the "BAT:" physical device is not included, since this assignment 
is used only to indicate that the RDR: and LST: devices are to be used for 
console irput/output.) | 


The ROR, LST, PUN, and CON devices are all defined within the BIOS 
portion of CP/M, and thus are easily altered fot any particular I/O system, 
(The current physical device mapping is defined by IOBYTE; see the "CP/M 
Interface Guide" for a discussion of this function). The destination device 
must be capable of receiving data (i.e., data cannot be sent to the punch), 
and the source devices must be capable of generating data (i.e., the LST: 
device cannot be read). 


The additional device names which can be used in PIP cammands are 


NUL: Send 40 "nulls" (ASCII @°s} to the device 
(this can be issued at the end of punched output). 


ECE : Send a CP/M end-of-file (ASCII ctl-2) to the 
Gestination device (sent automatically at the 
end of all ASCII data transfers through PIP), 


INP: Special PIP input source which can be “patched” 
into the PIP program itself: PIP gets the input 
data character-by-character by CALLing location 
103H, with data returned in location 109H (parity 
bit must be zero). 


OUT: Special PIP output destination which can be 
patched into the PIP program: PIP CALLS location 
106H with data in register C for each character 
to transmit. Note that locations 199H through 
1FFH of the PIP memory image are not used and 
can be replaced by special purpose drivers using 
DDT (see the DDT operator's manual). 


PRN: Same as LST:, except that tabs are expanded at 
every eighth character position, lines are 
numbered, and page ejects are inserted every 60 
lines, with an initial eject (same as [t8npl). 


File and device names can be interspersed in the PIP commands, In each 
case, the specific device is read until end-of-file (ctl-2 for ASCII files, 
and a real end of file for non-ASCII disk files), Data fram each device or 
file is concatenated from left to right until the last data source has been 
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read. The destination device or file is written using the data from the 
source files, and an end-of-file character (ctl-2) is appended to the result 

for ASCII files. Note if the destination is a disk file, then a temporary 

file is created ($$$ secondary name) which is chamec to the actual file name 

only upon successful campletion of the copy. Files with the extension "COM" 
are always assumed to be non-ASCII. 


The copy operation can be aborted at any time by depressing any key on 

_ be keyboard (a rubout suffices).  PIP will respond with the message "ABORTED" 

co indicate that the operation was not completed. Note that if any operation 

is aborted, or if an error occurs during processing, PIP removes any pending 
commands which were set up while using the SUBMIT command, 


It should also be noted that PIP performs a special function if the 
destination is a disk file with type "HEX" (an Intel hex formatted machine 
code file), and the source is an external peripheral device, such as a paper 

_ tape reader, In this case, the PIP program checks to ensure that the source 
file contains a properly formed hex file, with legal hexadecimal values and 
checksum records, When an invalid input record is found, PIP reports an error 
message at the console and waits for corrective action, It is usually 

. sufficient to open the reader and rerun a section of the tape (pull the tape 
back about 28 inches). When the tape is ready for the re-reaó, type a single 
carriage return at tbe console, and PIP will attempt another read. If the 
tape position cannot be properly read, simply continue the read (by typing a 

. return following the error message), and enter the record manually with the ED 
program after the disk file is constructed. For convenience, PIP allows the 
end-of-file to be entered from the console if the source file is a RDR: 
Movice. In this case, the PIP program reads the device ard monitors the 

. keyboard, If ctl-2 is typed at the keyboard, then the read operation is 
terminated normally. 


Valid PIP cammands are shown below, 


PIP LST: = X,PRN cr Copy X.PRN to the LST device and 
terminate the PIP program. 


PIP cr Start PIP for a sequence of 
commands (PIP prompts with "*"). 


*CON: =X.ASM,Y.ASM,Z,ASM CI Concatenate three ASM files and 
a copy to the CON device. 


*tX. HEXZCON: , Y, HEX, PTR; cr Create a HEX file by reading the 
| CON (until a ctl-2 is typed), fol- 
lowed by data from Y,HEX, followed 
by data from PTR until a ctl-2 is 
encountered, 


*cr Single carriage return stops PIP. 
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PIP PUN:=NUL: ,X.ASM,EOF:,NUL: cr Send 48 nulls to the punch device; 
then copy the X.ASM file to the 
punch, followed by an end-of-file 

i (ctl-2) and 48 more null charac- 
ters, 


The user can also specify one or more PIP parameters, enclosed in left 
-and right square brackets, separated by zero or more blanks, Each parameter 
iffects the copy operation, and the enclosed list of parameters must 
bimediately follow the affected file or device, Generally, each parameter can 
xe followed by an optional decimal integer value (the S and Q parameters are 
-»:xceptions), The valid PIP parameters are listed below, 


B Block mode transfer: data is buffered by PIP until an ASCII 
x-off character (ctl-S) is received fram the source device, 
This allows transfer of data to a disk file fram a continuous 
reading device, such as a cassette reader, Upon receipt of 
the x-off, PIP clears the disk buffers and returns for more 
irput data, The amount of data which can be buffered is de- 
pendent upon the memory size of the host system (PIP will 
issue an error message if the buffers overflow). 


Dn Delete characters which extend past colum n in the transfer 
= of data to the destination fran the character source, This 
parameter is used most often to truncate long lines which are 
sent to a (narrow) printer or console device, 


> E Echo all transfer operations to the console as they are being 
i performed, 
F Filter form feeds fram the file, All imbedded form feeds are 


removed, The P parameter can be used simultaneously to 
insert new form feeds, 


H Hex data transfer: all data is checked for proper Intel hex 
E file format. Non-essential characters between hex records 
are removed during the copy operation, The console will be 
prampted for corrective action in case errors occur, 


] I Ignore ":00" records in the transfer of Intel hex format 
file (the I parameter automatically sets the H parameter). 
" L Translate upper case alphabetics to lower case, 
N Add line numbers to each line transferred to the destination 


starting at one, and incrementing by l. Leading zeroes are 
suppressed, and the number is followed by a colon, If N2 

is specified, then leadirg zeroes are included, and a tab is 
inserted followiig the number, The tab is expanded if T is 
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Qs?z 


Sstz 


set. 


Cbject file (non-ASCII) transfer: the normal CP/M end of 
File is ignored, 


Include page ejects at every n lines (with an initial page 
eject). If n= ] or is excluded altogether, page ejects 
occur every 60 lines. If the F parameter is usec, form feed 
Suppression takes place before the new page ejects are 
inserted, 


Quit copying fram the source device or file when the 
string s (terminated by ctl-Z) is encountered, 


Start copying fram the source device when the string s 1S 
encountered (terminated by ctl-2). The S and Q parameters 
can be used to "abstract" a particular section of a file 
(such as a subroutine), The start and quit strings are al- 
ways included in the copy operation. 


NOTE - the strings following the s and q parameters are 
translated to upper case by the CCP if form (2) of the 
PIP canmand is used, Form (1) of the PIP invocation, how- 
ever, does not perform the automatic upper case translation, 
(1) PIP cr 
(2) PIP "cammand line" cr 


£xpand tabs (ctl-I characters) to every nth column during the 
transfer of characters to the destination from the source, 


Translate lower case alphabetics to upper case during the 
the copy operation. 


Verify that data has been copied correctly by rereading 
after the write operation (the destination must be a disk 


file). 
Zero the parity bit on input for each ASCII character, 


The following are valid PIP commands which specify parameters in the file 


PIP X,ASM=B: [v] cr Copy X.ASM from drive B to the current drive 


and verify that the data was properly copied, 


PIP LPT:=X,AM int8u] cr Copy X.ASM to the LPT: device; number each 


line, expand tabs to every eighth colum, and 
translate lower case alphabetics to upper 
case, 
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PIP PUN:-X.HEX[i],Y.2OT[h] cr First conv X.HEX to the PUN: device and 
ignore the trailing “:@@" record in X.HEX; 
then continue the transfer of data by reading 
Y.ZOT, which contains hex records, including 
amy ":00" records which it contains, 


PIP X.LIB = Y,ASM [ sSUBRl:'2 QJMP L3'z } cr Copy from the file Y,ASM 
into the file X.LIB, Start the copy when the 
string "SUBR]:" has been found, and quit copy- 
ing after the string "JMP L3" is encountered, 


PIP PRN:=X. ASM [p58] Send X,ASM to the LST: device, with line num- 
bers, tabs expanded to every eighth colum, 
and page ejects at every 58th line, Note that 
ntBp68 is the assumed parameter list for a PRN 
file; p5@ overrides the default value, 


6.5, ED ufn cr 


The ED program is the CP/M system context editor, which allows creation 
and alteration of ASCII files in the CP/M enviromment, Complete details of 
operation are given the ED user's manual, "ED: a Context Editor for the CP/M 
Disk System," In general, ED allows the operator to create and operate upon 
source files which are organized as a sequence of ASCII characters, separated 
by end-of-line characters (a carriage-return line-feed sequence). There is no 
practical restriction on line length (no single line can exceed the size of 
the working memory), which is instead defined by the number of characters 
typed between cr’s, The ED program has a number of commands for character 
string searching, replacement, and insertion, which are useful in the creation 
and correction of programs or text files under CP/M. Although the CP/M has a 
limited memory work space area (approximately 5000 characters in a 16K CP/M 
System), the file size which can be edited is not limited, since data is 
easily "paged" through this work area, 


Upon initiation, ED creates the specified source file, if it does not 
exist, and opens the file for access, The programmer then "appends" data £r om 
the source file into the work area, if the source file already exists (see the 
A command), for editing, The appended data can then be displayed, altered, 
and written from the work area back to the disk (see the W cammand), 
Particular points in the program can be automatically paged and located by 
context (see the N cammand), allowing easy access to particular portions of a 
large file, 


Given that the operator has typed 


ED X,ASM cr 
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—the ED program creates an intermediate work file with the name 
X. 555 


—to hold the edited data during the ED run. Upon campletion of ED, the X. ASM 
file (original file) is renamed to X.BAK, and the edited work file is renamed 
to X.ASM. Thus, the X.BAK file contains the oriainal (unedited) file, and the 
X.ASM file contains the newly edited file. The operator can always return to 

—@he previous version of a file by removing the most recent version, and 
.enaming the rrevious version, Suppose, for example, that the current X.ASM 
file was improperly edited; the sequence of CCP camand shown below would 


reclaim the backup file. 


— 


DIR X.* Check to see that BAK file 
is available. 
m ERA X,ASM Erase most recent version. 


REN X,ASM=X, BAK Rename the BAK file to ASM, 


Note that the operator can abort the edit at any point (reboot, power failure, 
ctl-C, or Q command) without destroying the original file. In this case, the 
BAK file is not created, and the original file is always intact. 


The ED program also allows the user to "ping-pong" the source and create 
backup files between two disks. The form of the ED cammand in this case is 


LS ED ufn d: 


where ufn is the name of a file to edit on the currently logged disk, and d is 
the name of an alternate drive. The ED program reads and processes the source 

- file, and writes the new file to drive d, using the name ufn, Upon campletion 
of processing, the original file becomes the backup file. Thus, if the 
operator is addressing disk A, the following cammand is valid: 


E ED X.ASM B: 


which edits the file X.ASM on drive A, creating the new file X.5$5 on drive 

_ B. Upon canpletion of a successful edit, A:X.ASM is renamed to A:X.BAK, and 
B:X.S$8 is renamed to B:X,ASM. For user convenience, the currently logged 
disk becomes drive B at the end of the edit. Note that if a file by the name 
B:X.ASM exists before the editing begins, the message 


FILE EXISTS 
is printed at the console as a precaution against accidently destroying a 


source file. In this case, the operator must first ERAse the existing file 
and then restart the edit operation. 
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Similar to other transient cammands, editing can take place on a drive 


different fram the currently logged disk by preceding the source file name Dy 
— a drive name, Examples of valid edit requests are shown below 


containing the CP/M operating system, 
for cammands, with interaction as shown below, 


ED A:X,ASM 


Edit the file X,ASM on drive A, with 


new file and backup on drive A, 


ED B:X,ASM A: 


Edit the file X.ASM on drive B to the 


temporary file X.$S$ on drive A, On 
termination of editing, change X,ASM 
on drive B to X.BAK, and chame X.5$$ 
on drive A to X.ASM, 


6,6. SYSGEN cr 


SYSGEN cr 


SYSGEN VERSION m.m 


The SYSGEN transient canmand allows generation of an initialized diskette 
The SYSGEN program prampts the console 


Initiate the SYSGEN program, 


SYSGEN sign-on message, 


SOURCE DRIVE NAME (OR RETURN TO SKIP) 


SOURCE ON x THEN TYPE RETURN 


FUNCTION COMPLETE 


DESTINATION ERIVE NAME (OR RETURN 


27 


Respond with the drive name (one 
of the letters A, B, C, or D) of 
the disk containing a CP/M sys- 
tem; usually A, If a copy of 
CP/M already exists in memory, 
due to a MOVCPM command, type a 
cr only, Typing a drive name 

x will cause the response: 


Place a diskette containirg the 
CP/M operating system on drive 

X (x is one of A, B, C, or D). 

Answer with cr when ready. 


System is copied to memory. 
SYSGEN will then prampt with: 


TO REBOOT) 

If a diskette is being ini- 
tialized, place the new disk 
into a drive and answer with 
the drive name, Otherwise, type 
a Cr and the system will reboot 
from drive A, Typing drive name 
x will cause SYSGEN to prampt 


— 


with: 


DESTINATION ON x THEN TYPE RETURN Place new diskette into drive 
x; type return when ready. 


FUNCTION COMPLETE New diskette is initialized 
in drive x, 


The "DESTINATION" prompt will be repeated until a single carriage return is 
typed at the console, so that more than one disk can be initialized. 


Upon canpletion of a successful system generation, the new diskette 
contains the operating system, and only the built-in commands are available, 


- A factory-fresh IBM-campatible diskette appears to CP/M as a diskette with an 


empty directory; therefore, tbe operator must copy the appropriate CDM files 
fram an existing CP/M diskette to the newly constructed diskette using the PIP 
transient, 


The user can copy all files fram an existing diskette by typing the PIP 
cammand 


PIP B: = A: *,*[v] cr 


which copies all files from disk drive A to disk drive B, and verifies that 
each file has been copied correctly. The name of each file is displayed at 
the console as the copy operation proceeds, 


It should be noted that a SYSGEN does not destroy the files which already 


exist on a diskette; it results only in construction of a new operating 


system, Further, if a diskette is being used only on drives B through D, and 
will never be the source of a bootstrap operation on drive A, the SYSGEN need 
not take place. In fact, a new diskette needs absolutely no initialization to 
be used with CP/M. 


6.7. SUBMIT uM parm#] ,.. parmén cr 


The SUBMIT command allows CP/M commands to be batched together for 
automatic processing. The ufn given in the SUBMIT command must be the 
filename of a file which exists on the currently logged disk, with an assumed 
file type of "SUB," The SUB file contains CP/M prototype commands, with 
possible parameter substitution. The actual parameters parmfl ... parmén are 
substituted into the prototype cammands, and, if no errors occur, the file of 
substituted conmands are processed seguentially by CP/M, 


2B 


The prototype cammand file is created using tbe ED program, with 
interspersed "$" parameters of the form 


$1 $2 $3 «wee Sn 


corresponding to the number of actual parameters which will be included when 
the file is submitted for execution, When the SUBMIT transient is executed, 
the actual parameters parmHl ... parmén are paired with tbe formal parameters 
as ... $n in the prototype cammands. If the number of formal and actual 
parameters does not correspond, then the submit function is aborted with an 
error message at the console, The SUBMIT function creates à file of 
substituted cammands with the name 


$$$ SUB 


on the logged disk, When the system reboots (at the termination of the 
- SUBMIT), this canmand file is read by the CCP as a source of input, rather 
than the console. If the SUBMIT function is performed on any disk other than 
drive A, the commands are not processed until the disk is inserted into drive 
A and the system reboots, Further, the user can abort cammand processing at 
- any time by typing a rubout when the canmand is read and echoed. In this 
case, the $5$.5UB file is removed, and the subsequent cammands come from the 
console. Command processing is also aborted if the CCP detects an error in 
any of the commands, Programs which execute under CP/M can abort processing of 
- cammand files when error conditions occur by simply erasing any existing 


SSS.SUB file. 


" In order to introduce dollar signs into a SUBMIT file, the user may type 

-'a "ss" which reduces to a single "$" within the command file. Purther, an 
up-arrow symbol "'" may precede an alphabetic character x, which produces a 
single ctl-x character within the file. 


The last camend in a SUB file can initiate another SUB file, thus 
allowing chained batch cammandsS. 


Suppose the file ASMBL,SUB exists on disk and contains the prototype 
cammands | 

ASM S1 

DIR $1.* 

ERA *, BAK 

PIP $2:=$1,PRN 

ERA S1.PRN 


and tbe cammand 
SUBMIT ASMBL X PRN cr 


is issued by the operator. The SUBMIT program reads the ASMBL.SUB file, 


substituting "X" for all occurrences of $1 and “PRN” for all occurrences of 
$2, resulting in a $$$.SUB file containing the commands 
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ASM X 

DIR X.* 

= ERA *, BAK 
PIP PRN: =X. PRN 
ERA X, PRN 


— which are executed in sequence by the CCP, 


The SUBMIT function can access a SUB file which is on an alternate drive 

by preceding the file name by a drive name. Submitted files are only acted 

- upon, however, when they appear on drive A, Thus, it is possible to create a 

submitted file on drive B which is executed at a later time when it is 
inserted in drive A, 


6,8. DUMP ufn cr 


The DUMP program types tbe contents of the disk file (ufn) at the console 
in hexadecimal form, The file contents are listed sixteen bytes at a time, 
with the absolute byte address listed to the left of each line in 
hexadecimal, Long typeouts can be aborted by pushing the rubout key dur ing 
printout. (The source listing of the DUMP program is given in the "CP/M 
Interface Guide" as an example of a program written for the CP/M environment.) 


~ 6.9. MOVCPM cr 


The MOVCPM program allows the user to reconfigure the CP/M system for any 
particular memory size. Two optional parameters may be used to indicate (1) 
the desired size of the new system amd (2) the disposition of the new system 
at program termination. If the first parameter is gmitted or a "*" is given, 
the MOVCPM program will reconfigure the system to its maximum size, based upon 
the kilobytes of contiguous RAM in the host system (starting aat 8008H). IT 
the second parameter is omitted, the system is executed, but not permanently 
recorded; if "*" is given, the system is left in memory, ready for a SYSGEN 
operation, The MOVCPM program relocates a memory image of CP/M and places 
this image in memory in preparation for a system generation operation, The 
command forms are: 


MONCPM cr Relocate and execute CP/M for manage- 
ment of the current memory configura- 
tion (memory is examined for contigu- 
ous RAM, starting at 188H). Upon com 
pletion of the relocation, the new 
system is executed but not permanently 
recorded on the diskette, The system 
which is constructed contains a BIOS 
for the Intel MDS 888. 
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MOVCPM n cr Create a relocated CP/M system for 
management of an n kilobyte system (n 
must be in the range 16 to 64), anc 
execute the system, as described above, 


MOVCPM * * cr Construct a relocated memory image for 
the current memory configuration, but 
leave the memory image in memory, in 
preparation for a SYSGEN operation, 


MOVCPM n * cr Construct a relocated memory image for 
: an n kilobyte memory system, and leave 
the memory image in preparation for a 

SYSGEN operation. 


The command 
MOVCPM * * 


for example, constructs a new version of the CP/M system and leaves it in 
memory, ready for a SYSGEN operation, The message 


READY FOR "SYSGEN" OR 
^SAVE 32 CPMxx,COM" 


is printed at the console upon campletion, where xx is the current memory size 
in kilobytes, The operator can then type 


SYSGEN cr Start the system generation, 


' SOURCE DRIVE NAME (OR RETURN TO SKIP) Respond with a cr to skip 
the CP/M read operation since the system 
is already in memory as a result of the 
previous MOVCPM operation, 


DESTINATION DRIVE NAME (OR RETURN TU REBOOT) 
Respond with B to write new system 
EE to the diskette in drive B. SYSGEN 
will prampt with: 
DESTINATION ON B, THEN TYPE RETURN 
Ready the fresh diskette on drive 
B and type a return when ready. 


Note that if you respond with "A" rather than "B" above, the system will be 
~- written to drive A rather than B. SYSGEN will continue to type the prompt: 


DESTINATION ORIVE NAME (OR RETURN TO REBOOT) 


- until the operator responds with a single carriage return, which stops the 
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A A KA os — 


SYSGEN program with a system reboot, 


The user can then go through the reboot process with the old or new 
diskette. Instead of performing the SYSGEN operation, the user couid have 


typed 
SAVE 32 CPMxx, 00M 
at the campletion of the MOVCPM function, which would place the CP/M memory 


image on the currently logged disk in a form which can be “patched,” This is 
necessary when operating in a non-standard environment where the BIOS must be 


"Maltered for a particular peripheral device configuration, as described in 


the"CP/M System Alteration Guide," 


Valid MOVCPM cammands are given below: 


MOVCPM- 48 cr Construct a 48K verskon of CP/M and start 
execution, 
MOVCPM 48 * cr Construct a 48K version of CP/M in prepara- 


tion for permanent recording; response is 


READY FOR "SYSGEN" OR 
"SAVE 32CPM48, COM" 


MOVCPM * * cr Construct a maximum memory version of CP/M 
and start execution, 


It is important to note that the newly created system is serialized with 
the number attached to the original diskette and is subject to the conditions 
of the Digital Research Software Licensing Agreement, 
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71. BDOS ERROR MESSAGES, 


There are three error situations which the Basic Disk Operating System 
intercepts during file Ux ocesssing. en ono cf these conditions is detected, 
the BDOS prints the message: 


BDOS ERR ON x: error 
where x is the drive name, and "error" is one of the three error messages: 


BAD SECTOR 
SELECT 
READ ONLY 


The "BAD SECTOR" message indicates that the disk controller electronics 
has detected an error condition in reading or writing the diskette. This 
condition is generally due to a malfunctioning disk controller, or an 
extremely worn diskette, If you find that your system reports this error more 
than once a month, you should check the state of your controller electronics, 
and the condition of your media, You may also encounter this condition in 
reading files generated by a controller produced by a different manufacturer. 
Even though controllers are claimed to be IBM-compatible, one often finds 
small differences in recording formats, The MIS-898 controller, for example, 
requires two bytes of one's following the data CRC byte, which is not required 
in the IBM format. Asa result, diskettes generated by the Intel MIS can be 
read by almost all other IBM-compatible systems, while disk files generated on 
other manufacturers equipment will produce the "BAD SECTOR" message when read 
by the MIS, In ary case, recovery from this condition is accomplished by 
typing a cti to reboot (this is the safest!), or a return, which simply 
, ignores the bad sector in the file operation. Note, however, that typing a 
return may destroy your diskette integrity if the operation is a directory 
write, So make sure you have adeguate backups in this case. 


The "SELECT" error occurs when there is an attempt to address a drive 
beyond the A through D rame, In this case, the value of x in the error 
message gives the selected drive, The system reboots following any input fram 
the console. 


The "READ ONLY” message occurs when there is an attempt to write to a 
diskette which has been designated as read-only in a STAT command, or has been 
set to reaj-only by the BDOS, In general, the operator should reboot CP/M 
either by using the warm start procedure (ctl-C) or by performing a cold start 
whenever the diskettes are changed. If a changed diskette is to be read but 
not written, BDOS allows the diskette to be changed without the warm or cold 
start, but internally marks the drive as read-only, The status of the drive 
is subsequently changed to read/write if a warm or cold start occurs, Upon 
issuing this message, CP/M waits for irput fram the console, An automatic 
warm start takes place following amy input. | 
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8, | OPERATION OF CP/M ON THE MS, 


This section gives operating procedures for using CP/M on the Intel MDS 
microcomputer development system, A basic knowledge of tne MIB hardware and 
software Systems is assumed, 


CP/M is initiated in essentially the same manner as Intel's ISIS 
operating system, The disk drives are labelled @ through 3 on the MLB, 
corresponding to CP/M drives A through D, respectively, The CP/M system 
diskette is inserted into drive 0, and the BOOT and RESET switches are 
" depressed in sequence. The interrupt 2 light should go on at this point. The 
Space bar is then depressed on the device which is to be taken as the system 
console, and the light should qo out (if it does not, then check connections 
and baud rates), The BOOT switch is then turned off, and the CP/M sianon 
message should appear at the selected console device, followed by the “A>” 
system prompt. The user can then issue the various resident and transient 
cammands 


The CP/M system can be restarted (warm start) at any time by pushing the 
INT @ switch on the front panel, The built-in Intel ROM monitor can be 
initiated by pushing the INT 7 switch (which generates a RST 7), except when 
operating under DOT, in which case the DDT program gets control instead, 


Diskettes can be removed from the drives at any time, and the system can 
be shut down during operation without affecting data integrity, Note, 
however, that the user must not remove a diskette and replace it with another 
without rebooting the system (cold or warm start), unless the inserted 
diskette is "read only," 


Due to hardware hang-ups or malfunctions, CP/M may type the message 
BDOS ERR ON x: BAD SECTOR 


where x is the drive which has a permanent error, This error may occur when 
drive doors are qpened and closed randomly, followed by disk operations, or 
may be due to a diskette, drive, or controller failure, The user can 
optionally elect to ignore the error by typing a single return at the 
console, The error may produce a bad data record, requiring re-initialization 
of up to 128 bytes of data, The operator can reboot the CP/M system and try 
the cperation again. 


Termination of a CP/M session requires no special action, except that it 
is necessary to remove the diskettes before turning the power off, to avoid 
random transients which often make their way to the drive electronics. 


It should be noted that factory-fresh IBM-campatible diskettes should be 
used rather than diskettes which have previously been used with any ISIS 
version. In particular, the ISIS "FORMAT" operation produces non-standard 
sector numbering throughout the diskette, This nor-standard numbering 
seriously degrades the performance of CP/M, and will operate noticeably slower 
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than the distribution version. If it becomes necessary to reformat a diskette 
(which should not be the case for standard diskettes), a program can be 
written under CP/M which causes the MIS 800 controller to reformat with 


Sequential sector numbering (1-26) on each track, 


—X ee 
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Note: "MIB 800" and "ISIS" are registered trademarks of Intel Corporation, 
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Ll. An ERNIS DE CPYA 2,29 PACIGILIES. 


CP/M4 2.29 is a nigh-=ertormance single-console operating system 
wnicn uses table driven tecnniaues +o allow field recontiguration to 
match a wide variety of disx cacacities. All of tne fundamental file 
restrictions are removed, wnile maintaining upward compatioility from 
previous versions of release l, Features of CP/M 2.0 include field 
specification of one to sixteen logical drives, eacn containing up to 
eignt megabytes, Any particular filo can reach tne full drive size 
witn the capaoility to expand to thirty-two megabytes in future 
releases, Ine directory size can be field contigured to contain any 
reasonable numoer Of entries, and each tile is ootionally tagged with 
read/oniy and system attributes, Users of CP/M 2.3 are ohysically 
separated oy user numbers, witn facilities for file copy Operations 
trom one user area to anotner, Powerful relative-record random access 
functions are cresent in CP/M 2.9 wnicn provide direct access to any 
of tne 65536 records of an eight megaoyte file. 


All disk-dependent portions ot CP/M 2,0 are placed into a 
BIOS-resident “disk parameter block” whicn is either nand coded or 
produced automatically using tne disk definition macro library 
provided with CP/M 2.4. Tne end user need only soecify tne maximum 
numoer of active  JisKs, tne starting and ending sector numbers, the 
data allocation size, the maximum extent of tne logical disx, 
directory size information, ana reserved track values. Ine macros use 
this inrormation to generate tne aoprooriate taoles and. table 
reterences for use during CP/M 2.0 ooeration. Deblocking information 
is also provided wnich aias in assembly or disassembly of sector sizes 
wnich are mulitioles or tne tundemental 126 ovte data unit, and tne 
system alteration manual includes general-purpose supbroutines wnich 
use tne tnis deolocking information to take aavantage of larger sector 
sizes. Use ot these subroutines, togetner witn the taole driven guata 
access algoritnms, make CP/M 2.0 truly a universal data management 
system, 


file expansion is acnieved by providing up to 312 logical tile 
extents, wnere eacn logical extent contains 16K bytes of data. CP/M 
2.0 is structured, nowever, so tnat as much as 128K bytes of data 15 
addressed by a single onysical extent (corresponding to a Single 
directory entry), tnus maintaining compatibility witn previous 
versions while taking full advantage ot directory space, 


Random access facilities are present in CP/M 2.0 wnicn allow 
immediate reference to any record of an eight megabyte file. Using 
CP/4's unique data organization, data plocks are only allocated wnen 
actually required and movement to a record position requires little 
searcn time. Sequentiai file access is uoward compatible from earlier 
versions to tne full eignt megaoytes, wnile random access 
compatibility stops at 512K byte files. Due to CP/M 2.U's simoler and 
faster random access, aoplication orogrammers are encouraged to alter 
tneir orograms to take full advantage of the 2.0 facilities. 


Several CP/M 2.0 modules ana utilities nave  imorovements  whicn 
correspond to the enhanced file system. STAT and PIP both account for 
file attributes and user areas, while tne CC? orovides a "login" 


(All Information Contained Herein is Proprietary to Digital Researcn.) 


l 


function to change from one user area to anotctner, rne CCP also 
Formats directory displays in a more convenient manner and accounts 
for potn CRT and nara-cooy devices in its ennanced iine editing 
functions, 


The sections below point out tne inaividual differences Detween 
CP/M 1.4 ana CP/M 2.0, witn tne understanding that tne reader 15 
eitner ramiiiar witn CP/M 1.4, or nas access tO ene 1.4 manuals. 
Additional information dealing witn CP/M 2.3 I/O system alteration is 
oresented in the Digital Researcn manual “CP/M 2.0 Alteration Guide.” 
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2.. USER INTERFACES 


Console line processing taxes CRi-tyne devices into account with 
three new control cnaracters, shown with an asterisk in tne list below 
{tne symbol "ctl" Dpelow indicates tnat tne control key 18S 
simultaneously depressed): 


rub/del removes and ecnoes last cnaracter 

cCtl-C reboot when at ceginanins 125p 

ctl-E ohysical end of line 

ctl-H packspbace one cnaracter position* 

cti-J (line feed) terminates current 1nout* 
ctl-M (carriage return) terminates inout 
ctl-R retype current line after new line 
ctl-y remove current line after new line 
ctl-X packspace to oeginning of current line* 


O 
th 


In particular, note tnat ctl-H produces the proper Dackspace overwrite 
function (ctl-H can be cnanged internally to anocner cnaracter, such 
as delete, through a simple single byte change).  Purtner, the line 
editor keeps track of the current cromot column position so tnat tne 
operator can properly align data input following a ctl-U, ctl-R, or 
ctl-X command, 
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3. CONSOLE COMMANO PROCESSOR (CCP) INTERFACE. 


There are four functional ditferences setween CP/M 1.4 and Ce/M 


2.0 at tne console command processor (CCP) levei. Tne CCP now 
displays directory information across ine screen (four elements Der 
line), tne USER command is present to allow maintenance or separate 
files in the same directory, and the actions of tne “ERA *.*^ and 
"SAVE"  commauds have changed. Ine alreres UIR rormac LS 


self-explanatory, wnile tne USER command takes tne form: 
USER n 


wnere n is an integer value in the range @ to 15.. Upon cold start, 
tne operator is automatically "logged" into user area number €, wnicn 
is compatible witn standard CP/M 1.4 airectories. Tne operator may 
issue the USER command at any time to move to anotner logical area 
within tne same directory. Drives whicn are logged-in while 
addressing one user numoer are automatically active wnen the operator 
moves to another user numoer since a user number 15 simply a prefix 
which accesses particular directory entries on the active Gisks. 


The active user number is maintained until changed by 4 
subseauent USER command, or until a colo start operation when user U 
is again assumed, 


Due to tne fact tnat user numoers now tay individual directory 
entries, tne ERA *.* commana has a Gifrertent erfect, In version 1.4, 
this command can ve used to erase a directory wnicn nas "garbage" 
information, oernaps resulting from use of a diskette under another 
operating system (heaven foroid!). In 2.90, nowever, the ERA ".* 
command affects only the current user numoer. f[nus, it is necessary 
to write a simple utility to erase a nonsense disk (the program simply 
writes the hexaaecimal pattern E5 tnroughout tne diss). 


The SAVE command in version 1.4 allows oniy a single memory save 
operation, with the potential of destroying the memory image due to 
directory operations following extent boundary changes. Version 2.2, 
nowever, does not perform directory operations in user data areas 
after disk writes, and thus the SAVE operation can De used any number 
of times without altering the memory image. 
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3. STAT ESdAd4CEMENTIS, 


tonal functions which 


[ne STAI orogram nas a nenoer of addit 
disolav, and file indicator 


allow aisx nerameter disolay, uset numocc- 
manipulation. [ne comnanc: 


STAT VAL: 


oroduces a summary of tne availac.e status commands, resulting in tne 
outout: 


Temo R/O Disk: d:=R/O 

Set Indicator: a:filename.tyo 3R8/O SR/w >SY> >DIR 
Jisk Status : DSK: G:DsK: 

User Status : USR: 

Iooyte Assign: 

(list of vossiole assignments) 


whicn gives an instant summary of tne possible STAT conmands. Tne 
command form: 

STAT a:filename.tyod >> 
wnere "à:" is an optional arive name, and "filename.typ" 1s ar 
unamoiguous or ambiguous file name, oroduces tne output disolay 
format: 


Size Recs Jytes Ext Acc 
4 d 4 à 6k l} R/J A: ED, COM 
35 55 | 12K ] R/D (A:BIP.CoOH) 
035360 123 2K 2 R/N A:X.DAT 
where tne 35 parameter causes the "Size" field to oe disolayec 
(without tne 335, tne Size fiela is skipped, out the remaining tielde 
are disolayed). Tne Size field lists the virtual file size in 


recoras, wnile the “Recs” field sums the number ot virtual records 1r 
each extent. For files constructed seguentially, tne Size and Recs 
fields are identical. The “Bytes” field lists tne actual number of 
bytes allocated to tne correspondina file. ihe minimum allocatior 
unit is determined at conriguration time, and thus tne numoer of bytes 
corresponds to the record count olus tne remaining unused space in the 
last allocated olock for seguential files. Random access files are 
given data areas only wnen written, so the Bytes field contains the 
only accurate allocation figure. In tne case of random access, the 
Size field gives tne logical end-of-tile record position and the Recs 
field counts the logical records of each extent (each of tnese 
extents, however, may contain unallocated "noles" even though tney are 
added into the record count). [ne “Ext” field counts the numoer of 
logical 16g extents allocated to the file. Unlike version 1.4, the 
Ext count does not necessarily correspond to tne number of directory 
entries given to che file, since tnere can De uo to 126K oytes (8 
logical extents) directly aüdressed py a single directory entry, 
depending upon allocation size (in a special case, there are actually 
256K bytes which can pe directly addressed by a ohysical extent). 


Tne "Acc" field gives the R/O or R/w access mode, whicn 15 
cnanged using the commanas shown below. Similarly, tne parentheses 
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'saown around tne PIP.COM file name indicate that it nas tne “system” 


indicator set, 30 that it will not pe listed in DIR commands. rne 
four command forms 


STAT d:filename.typ 3nR/O 
STAT d:filename.tvo 3R/w 
STAT d:filename.tyo ySYS 
STAT d:filename,tyo SDIR 


set or reset various permanent file indicators. Tne R/U  1nd1cator 
places the file (or set of files) in a read-only status until cnanged 


py a subsequent STAT command. The R/O status is recorded in tne 


Girecter with tne file so that it remains R/O througn intervening 
cold start operations, The a/W indicator places the file in a 
permanent read/write status. The SYS indicator attaches the system 

mdicator to the file, while the DIR command removes the system 


indicator. Tne "filename.tyo" may be ambiguous or unampiauous, but in 


eitner case, the files wnose attributes ace changed are listed at the 
console when the cnange occurs, The drive name denotea py “d:" 1S 
optional. 


nen a file is marked R/O, subsequent attempts to erase Or write 
into the file result in a terminal 8005 message 


ados grr on d: File R/O 


The BOOS tnen waits for a console input before performing a subsequent 
warm start (a "return" is sufficient to continue). The command form 


STAT d:DSK: 


lists the drive characteristics of tne disk named by "d:" which is in 
tne range A:, B:, ..., Pi. The drive characteristics are listed in 


ne format: 


d: Orive Cnaracteristics 
65536: 128 Byte record Capacity 
8192: Kilopyte Drive Capacity 
128: 32 Byte Directory Entries 
9: Checked Directory Entries 
1024: Records/ Extent 
128: Records/ Block 
58: Sectors/ Track 
2: Reserved Tracks 


where "d:" is the selected drive, followed by the total record 
capacity (65536 is an 8 megabyte drive), | followed by the total 
capacity listed in Kilooytes, The directory size is listed next, 
followed by tne "checked" entries. The number of checked entries is 
usually identical to the directory size for removable media, since 
this mecnanism is used to detect changed media during CP/M operation 
without an intervening warm start. For fixed media, the number is 
usually zero, since the media is not changed without at least a cold 
Ot warm start. The number of records per extent determines the 
addressing capacity of eacn directory entry (1024 times 128 Dytes, OF 
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123% in the example above). The number of records per block shows the 
basic allocation size (in the example, 128 records/olock times 128 
bytes per record, or l6X bytes Der plock}. The listing is then 
followed by tne number ot physical sectors per track and the number of 
reserved tracks. For logical drives wnicn share the same physical 
disk, the number of reserved tracks may be guite lacge, since this 
mechanism is used to skio lower-numbered disk areas allocated to otner 
logical disxs. The command form 


STAT DSK: 


produces a drive cnaracteristics table for all currently active 
árives. Tne final SIAT command form is 


STAT USR: 


which produces a list of the user numbers whicn have files on the 
currently addressed disk. Tne display format is: 


Active User : Y 
Active Files: Y l 3 


wnere tne first line lists the currently addressed user number, as set 
by tne last CCP USER command, followed by 4 list of user numbers 
scanned from the current directory. In tne above case, tne active 
user numper is v (default at cold start), witn three user numbers 
whicn nave active files on the current disk. The operator Can 
subsequently examine the directories of the other user numbers by 
logging-in witn USER 1, USER 2, or USER 3 commands, followed by a DIF 
command at tne CCP level. 
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5. PIP ENHANCEMENTS. 


PI? provides three new functions wnicn account for tne features 
of CP/M 2.4. all tnree runctions taxe the form of file parameters 
wnicn are enclosed in square orackets foliowing tne appropriate rile 
names. The commanas are: 


Gn Get File from User numper n 
(n in the range v = 15) 
W write over R/O files without 


console interrogation 
R Read system files 


Me G command allows one user area to receive gata files from anotner. 


Assuming the operator has issued the USER 4 command at the CCP level, 
tne PIP statement 


PIP X.Y = X.Y[G2] 


reads file X.Y from user numper 2 into user area number 4, fne 
command 


PIP ARAS ES] 


copies all of tne tiles from the A drive directory for user number 2 
into the A drive directory of the currently loggea user number. Note 
that to ensure file security, one cannot copy files into a different 
area than the one which is currently addressed by tne USER command. 


Note also that the PIP program itself is initially copied to a 
user area (so that subsequent tiles can be copied) using the SAVE 
command. The sequence ot operations shown below effectively moves PIP? 
AE Om one user area to the next. 


USER 4 login user Y 

DOT PIP.COM load PIP to memory 
(note PIP size s5) 

GU return to CCP 

USER 3 login user 3 


SAVE s PIP.COM 


where s is the integral number of memory "pages" (256 byte segments) 
occupied by PIP. Ihe number s can be determined when PIP.COM is 
loaded under ODT, by referring to the value under the "NEXT" disolay. 
tf for example, the next available address is 1009, then PIP.COM 
requires lC hexadecimal pages (or l times 16 + 12 = 28 pages), and 
thus the value of s is 28 in the subsequent save. Once PIP 15 copied 
in this manner, it can then be copied to another disk belonging to the 
same user number through normal pio transfers. 


Under normal operation, PIP will not overwrite a file which is 


set to a permanent R/O status. If attempt is made to overwrite a R/O 
file, the promot 
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PALIN DILE GA Ros Dees INTE 


is issued. If the operator responds witn the character "y" then tht 
file is overwritten, Otnerwise, the response 


** NOT.DELETED ** 


is issued, the file transfer is skiopped, and PIP continues witn thí 
next operation in sequence. In order to avoid the promot and respons: 
in the case of R/O file overwrite, tne command line can include the > 
parameter, as shown below 


PIP A:-28:*.COM[w] 


which copies all non-system files to the A drive from the 8 drive, an 
overwrites any R/O files in the process. If the operation involve. 
several concatenated files, tne Y parameter need only be included wit! 
-ne last file in the list, as shown in tne following example 


PIP A.DAT = B.OAT,F:NEW.DAT,G:OLD.DAT[w] 


files witn the system attribute can be included in PIP transfer: 
if the R parameter is included, otherwise system files are no 
recognized, The command line 


PIP ED,CUM = 3:ED,CUMÍ|R] 


for example, reads the ED.COM file from tne 8 drive, even if it na 
Seen marked as a R/O ano system file, The system file attributes ar 
conied, 1f present, 


It should oe noted that downward compatibility with previou 
versions of C?/M is only maintained if the file does not exceed on 
megabyte, no file attributes are set, and the file is created Dy use 
B. If compatibility is required with non-standara (e.g., "doubl 
density") versions of 1.4, it may be necessary to select l. 
compatibility mode when constructing the internal disk parameter bloc 
(see tne “CP/M 2.0 Alteration Guide," and refer to Section 14 whic 


descrioes 8IOS differences). 
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6. ED ENHANCEMENTS. 


The CP/M standard orogram editor provides several new facilities 
in the 2.0 release. Experience has shown tnat most operators use the 
relative line numzcrin2 feature of ED, and thus the editor nas tne "v" 
(Verify Line) option set as an initial value. Tne operator can, of 
course, disable line numpering by typing the "-v" command, If you are 
— not familiar witn the ED line number mode, you may wish to refer to 
tne Appendix in tne ¿D user's guide, where tie "v" command is 
described. 


ED also taxes file attributes into account. If the operator 
attempts to edit a reaa/only file, the message 


** FILE IS READ/ONLY ** 


“ppears at the console. The file can oe loaded and examined, out 
cannot oe altered in any way. Normally, the operator simoly ends the 
edit session, and uses STAT to cnange the file attribute to R/w. If 
tne edited file nas the "system" attribute set, the message 


"SYSTEM" FILE NOT ACCESSIBLE 
is displayed at the console, and tne edit session is aborted. Again, 
the STAT orogram can be used to change the system attrioute, if 


desirea, 


Finally, the insert mode ("i") command allows CRT line editing 
functions, as described in Section 2, above. 
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7. THE XSUB FUNCTION. 


An additional utility program is supplied with version 2.8 of 
cp/M, called XSUB, which extends the power of the SUBMIT facility to 
include line input to programs we well as the- console command 
processor, The XSUB command 1S included as the first line of your 
submit file and, when executed, self-relocates directly below the CCP. 
All subsequent submit command lines are processed by XSUB, SO that 
programs which read buffered console input (BDOS function 10) receive 
their input directly from the submit file. For example, the file 
SAVER.SUB could contain the submit lines: 


XSUB 

DDT 

ISl.dEX 

R 

Ge 

SAVE 1 $2.COM 


with a subsequent SUBMIT command: 
SUBMIT SAVER X Y 
which substitutes X for S] and Y for $2 in the command stream. The 
XSUB program loads, followed by DDT which is sent the command lines 
“TX HEX" "R" and “GB” thus returning to the CCP. The final command 
“SAVE 1 Y.COM" is processed by the CCP. 
The XSUB program remains in memory, and prints the message 
(xsub active) 

on each warm start operation to indicate its presence. Subsequent 
submit command streams do not require tne XSUB, unless an intervening 


cold start has occurred. Note that XSUB must De loaded after DESPOOL, 
if both are to run simultaneously. 


(A11 Information Contained Herein is Proprietary to Digital Research.) 


11 


d. BDOS INTERFACE CONVENTIONS. 


CP/M 2.8 system calls take place in exactly the same Tanner as 
earlier versions, with a call to location 6005H, function number in 
register C, and information address in register pair DE. Single byte 
values are returned in register A, with double pyte values returned in 
-at (for reasons of compatibility, register A = L and register 8 = H 
upon return in all cases). A lisi of CP/M 2,0 calls is given below, 
with an asterisk following functions which are either new Or revised 
from version 1.4 to 2.0. Note that a zero value is returned LoT 
“out-of range function numpers. 


yg System Reset 19* Delete File 

1 Console Input 20 Read Sequential 

2 Console Outout 21 write Sequential 

` 3 Reader Inbut 22* Make File 

4  Puncn Jutbut 23* Rename File 

> List Outour 24* Return Login Vector 

6* Direct Console I/O 25 Return Current Disk 

r Get I/0 dyte 26 Set OMA Address 

d Set I/O Byte 27 Get Addr(Alloc) 

Y Print String 23* write Protect DISK 
l@* Read Console Buffer 29* Get Addr(R/J Vector) 
1l Get Console Status 30* Set File Attributes 
12* Return Version Number 31* Get Addr(Disk Patms) 
13 Reset Disk System 32* Set/Get User Co3e 
14 Select Disk 33* Read Random 
15* Oven File 34* Write Random 
16 Close File 35* Comoute File Size 
17* Search for First 36* Set Panaom Record 


18* Searcn for Next 


(Functions 25, 29, and 32 snould be avoided in application programs to 
maintain uoward compatibility with MP/M.) The new or revised functions 
Sire described below. 


Function 6: Direct Console l/U. 


Direct Console 1/0 is supported under CP/"i 2.4 for those 
applications where it is necessary to avoid tne 8005 console I/O 
operations. Programs whicn currentiy perform direct I/V tnrougn the 
3105 shoulá be cnanged to use direct I/O under sDO5 so that tney can 
be fully supported under future releases of MP/M and CP/M. 


Upon entry to function 6, register E eitner contains hexadecimal 
FF, denoting a console input request, or register E contains an ASCII 
cnaracter. If the input value is FF, then function 6 returns A = de 
if no cnaracter is ready, otherwise A contains the next console input 
character. 


If the input value in E is not FF, then function 6 assumes that 
E contains a valia ASCII character wnicn iS sent to the console, 
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Function ld: Read Console Butrer. 


Phe console buffer read ooeration remains uncnanged except that 
console line editing 18 supported, as descrioed in Section 2. Note 
also that certain functions wnicn return the carriage to the leftmost 
oosition (e.g., ctl-X) do so only to tne column position where the 
prompt ended (previously, the carriage returned to tne extreme left 


margin). This new convention makes operator data inout and line 
correction more legible. 


Function l2: Return version Number. 


rünction 12 has been redefined to nrovide information which 
allows  version-indeoendent orogramming (this was oreviously the "lift 
head” function whica returned HLed008 in version 1,4, but performed no 
operation). Ine value returned by function 12 is a  two-ovte value, 
with H = 00 for tne CP/M release (1 = gi for MP/M), and L = Ud foc all 
releases previous to 2.8. CP/M 2.0 returns a hexadecimal 20 in 
register L, with subsequent version 2 releases in the hexadecimal 
range 21, 22, tnrougn 2E. Using function 12, for examole, you can 
write application programs wnicn orovide botn sequential and random 
access functions, witn random access disabled when ooerating under 
early releases of CP/M. 


In the file ooerations descrived below, DE addresses a file 
control olock (FCB). Furtner, all directory operations take place in 
a reserved area whicn does not affect write pufters as was tne case in 
version 1.4, witn the exception of Searcn First and Search Next, where 
comoatioility is required, 


ne File Control 3locx (FCB) data area consists ot a sequence of 33 
oytes for sequential access, and a series of 36 bytes in tne case chat 
tne file is accesseo randomly. The default file control plock 
normally located at Ju5CH can be used for random access files, since 
oytes  807DH, BU7EH, and 2O9907FH are available for this purpose. For 
notational purposes, the Fcs format is shown with the following 
fielas: 


(All Information Contained Herein is Proprietary to Digital Research.) 


L3 


A aida 


An E ew ta 


00 01 82 ... 06 49 18 ll 12 13 14 15 16 ... 3i 32 33 34 35 
where 


dr drive code {0 - 16) 
ð => use default drive for file 
l => auto disk select drive A, 
2 => auto disk select drive B, 


+ > b 


l62» auto disk select drive P. 


Elo ES contain the file name in ASCII 


- at, upper case, with nigh bit = 0 


tl,t2,t3 contain the file type in ASCII 
upper case, with high bit = 0 
tl', t2', and t3' denote the 
bit of these positions, 
tl' = 1 => Reac/Only file, 
t2' = 1 => SYS file, no DIR list 


ex contains the current extent number, 
normally set to 08 by the user, but 
in range ð - 31 during file 1/0 


sl reserved for internal system use 


S2 reserved for internal system use, set 
to zero on call to OPEN, MAKE, SEARCH 


rc record count for extent "ex," 
^ takes on values from Y - 128 


do...dn filled-in by CP/M, reserved for 
system use 


cr current record to read or write in 
a sequential file operation, normally 
set to zero by user 


rü,rl,r2 optional random record number in the 
range 8-65535, with overflow to TL 


rÜü,rl constitute a 16-bit value with 
low byte r, and high byte rl 


Function 15: Open File. 

Tne Open File operation is identical to previous definitions, 
with the exception that byte s2 is automatically zeroed. Note that 
previous versions of CP/M defined this byte as zero, but made no 
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w 


uOward comoatloility 


A 
™~ on ms -— 
= a.u», 


ance, > 
the latest versi 


~ 


Function 17: Searcn for First. 


Searcn First scans the directory for a match with the file Jiven 
oy tne FCs addressed by DE. The value 253 (nexadecimal FF) ig 
returned if the file is not found, otnerwise a value Of A equal to y 
l, 2, or 3 is returned indicating tne file is present, it tne “ense 
tnat tne file is found, tne current DMA address is filled vita tne 
record containing tne directory entry, ana tne relative startin- 
position is A * 32 (i.e., rotate tne A register left 5 pits, or Aon A 
five times). Altnough not normally required for application programs, 
the directory information can be extracted from the buffer at tais 
position. 


An ASCII question mark (63 decimal, 3F hexadecimal) in any 
position from fl through ex matcnes the corresponding field of any 
directory entry on the default or auto-selected disk Crive, If tne gr 
field contains an ASCII question mark, then the auto dísk select 
function is disadled, the default disk is searched, with the searen 
function returning any matched entry, allocated or free, celonging to 
any user number, This latter function is not norraliy useó Dy 
aopiication orograms, out does allow complete flexibility to scan al? 
current directory values. If the dr field is not a question mark, tne 
52 byte is automatically zeroed. 


Function l8: Search for Next. 


The Search Next function is similar to the Search First 
function, except that the directory scan continues from the last 
matched entry. Similar to function 17, function 13 returns tne 
decimal value 255 in A when no more directory items matcn, 


Function 19: Delete File, 


The Delete File function removes files which zaten the pep 
addressed by DE. The filename and type may contain ambi3uous 
references (i.e., question marks in various positions), zut tne arivye 
select code cannot De ambiguous, as in the Search and Searcn dext 
functions. 


Function 19 returns a decimal 255 if the reference file or files 
could not be found, otherwise a value in the range @ to 3 is returned, 
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Function 22: Make File, 


Phe Make File operation is identical to previous versions ot 
“p/M, except that byte s2 is zeroed upon entry to cne 3DOS. 


Function 23: Rename File. 


The Actions of the file rename functions are the same as 
previous releases except that the value 255 is returned if the rename 
function is unsuccessful (the file to rename could not be found), 
otnerwise a value in tne range v to 3 is returned. 


Function 24: Return Login vector. 


The login vector value returned by CP/M 2,0 is à ló-Dit value in 
HL, where the least sicnificant bit of L corresponds to tne first 
drive A, and the nigh order vit of B corresponds to tne sixteentn 
drive, lapelled P. Note that compatioility is maintained with earlier 
releases, since registers A and L contain the same values upon return. 


Function 28: write Protect Current Disk. 


The disk write protect function provides temoorary write 
protection for the currently selected disk. Any attemot to write to 
the disk, before the next cold or warm start operation produces the 


message 


Bdos Err on d: R/O 


9, 


Function 29: Get R/O Vector, 


Punction 29 returns a bit vector in register pair HL which 
indicates drives which have the temoorary read/only oit set. Similar 
to function 24, tne least significant Dit corresponds to drive A, 
while the most significant bit corresponds to drive p. The R/O bit iS 
set either by an explicit call to function 28, or by tne automatic 
software mechanisms within CP/M whicn detect changed disks. 


Function 38: Set File Attributes. 


Tne Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files. In 
particular, the R/O and System attributes (tl' and t2' above) can pe 
set or reset. The DE pair addresses an unambiguous file name with the 
appropriate attributes set or reset. Function 3@ searches for a 
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matcn, and cnanges the matched directory entry to contain tue selected 
incicators. Indicators fl’ tnrough £4’ are not oresently used, but 
may be useful for applications programs, since tney are not involved 
in the matching orocess during file open and ciose operations, 
Indicators ¢5' tnrough fà' and t3' are reserved for future system 
expansion, 


Function 31: Get Disk Parameter 3locx Aadress. 


Phe address of tne BIOS resident disk parameter olock is 
returned in HL as a result of tnis function cali.  ThiS address can be 
used fot eitner of two purposes. First, the disk parameter values can 
De extracted for display and space computation purposes, OF transient 
programs can dynamically change tne values of current disk parameters 
when the disk environment changes, if required. Normally, aoolication 
programs will not require this facreLey. 


Function 32: Set or Get User Code, 


An application program can change or interrogate the currently 


active user number by calling function 32. If register € = FF 
nexadecimal, tnen tne value of the current user number is returned. in 
register A, where the value 15 in the range Jd to 3l. If register E 1s 


not Ff, then the current user numoer is changed to the value of E 
(modulo 32). 


Function 33: Read Random. 


The Read Random function is similar to the seguential file read 
operation of previous releases, except that the read operation takes 
vlace at a particular record number, selected by the 24-bit value 
constructed from the tnree pyte field following the FCB (byte 
vositions rà at 33, rl at 34, and r2 at 35). Note that the sequence 
of 24 bits is stored with least significant oyte first 11), middie 
byte next (rl), and hign byte last (r2). C?/M release 2.8 does not 
reference byte r2, except in computing the size of a file (function 
35). Byte r2 must be zero, however, since a non-zero value indicates 


overflow past tne end of fiie. 


Thus, in version 2.9, the r@,rl byte pair is treated as a 
double-pyte, or "word" value, whicn contains the record to read. This 
value ranges from «ù to 65535, proviaina access to any particular 
record of the 8 megabyte file. In order to process a file using 
random access, the base extent (extent 88) must first be opened. 
Altnough the pase extent may or may not contain any allocated data, 
this ensures tnat tne file is properly recorded in the directory, and 
is visible in DIR requests. The selected record number is then stored 
into the random record field (rd,r1), and tne BDOS is called to read 
the record. Upon return from the call, register A either contains an 
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error code, as listed below, or the value 90 indicating the operation 
was successful. In the latter case, the current DMA address Contains 
tne randomly accessed record. Note that contrary to the sequential 
reaá operation, the record number iS not advanced, Tnus, suosequent 
random read operations continue to read the same record, 


Upon eacn random read operation, the logical extent and current 


record values are automatically set. Thus. the file can De 
sequentially read or written, starting from tne current randomiy 
accessed position, Note, however, that in this case, the last 


randomly read record will be re-read as you switch from random mode to 
sequential read, and the last record wili be re-written as you switch 
to a seguential write operation, You can, of course,  simcly advance 
tne random record position following each ranaom read or write to 


obtain tne effect of a sequential I/O operation, 


à 
Error codes returned in register A following a random read are 


listed below. 


dl] reading unwritten data 

82 (not returned in ranaom mode) 
33 cannot close current extent 

4 seek to unwritten extent 

95 (not returned in reau mode) 

36 seek past ohysical end of disk 


Error coae el and vá occur wnen a random reaa operation accesses a 
data plock which has not peen previously written, or an extent which 
nas not been created, wnicn are equivalent conaitions, Error 3 does 
not normally occur under proper system operation, but can De cleared 
by simply re-reading, or re-opening extent zero as long as tne disk 1S 
not physically write protected. Error code 86 occurs whenever byte r2 
is non-zero under the current 2.2) release. Normally, non-zero return 
codes can be treated as missing data, witn zero return codes 


^"Üjndicating operation complete. 


Function 34: Write Random. 


The write Random operation is initiated similar to the Read 
Random call, except that data is written to the disk from the current 
DMA address. Further, if the disk extent or data block which is the 
target of the write has. not yet been allocated, the allocation is 
performed before the write operation continues. As in the Read Random 
operation, the random record number is not changed as a result of the 
write. The logical extent number and current record positions of the 
file control block are set to correspond to the random record which is 
being written, Again, sequential read or write operations can 
commence following a random write, with the notation that the 
currently addressed record is either read or rewritten again as the 
sequential operation begins. You can also simply advance the random 
record position following each write to get the effect of a sequential 
write operation, Note that in particular, reading or writing the last 
record of an extent in random mode does not cause an automatic extent 
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exc 


e 


switcn as 28 aces in seuuentia: mode under eitner CP/M 1.4 or CP/M 
2.0. 


fne error codes returned py a random write are identical to the 
random read operation with tne addition of error code v5, wnich 
indicates that a new extent cannot oe created Jue to dicectory 
overflow. 


Punction 35: Comoute File Size. 


when computing the size of a file, the ODE register  oair 
addresses an FC3 in random mode format (bytes r@, rl, and r2 are 
oresent). The FCB contains an unambiguous file name which is used in 
the directory scan. Upon return, the random record bytes contain the 
"virtual" file size wnicn is, in eftect, tne record address ot the 
record following tne end of the file. if, following a call to 
function 35, the high record oyte r2 is dl, then tne file contains the 
maximum record count 63536 in version 2.0. Otherwise, bytes rd and rl 
constitute a l6-o0it value (rd is the least significant oyte, as 
oefore) whicn is the file size. 


Data can pe aooended to tne end of an existing file Dy simoly 
calling function 35 to set tne random record position to the end of 
file, tnen oertorming a seguence of random writes starting at the 
oreset record address. 


Tne virtual size of a file corresponds to the physical size when 
the file is written sequentially. If, instead, the file was created 
in ranáom mode and "holes" exist in the allocation, then tne file may 
in fact contain fewer records than the size indicates. If. EOL 
example, only the last record of an eight megabyte file is written in 
random mode (i.e., record number 65535), then the virtual size ls 


2165536 records, although only one olock of data is actually allocated. 


Function 36: Set Random Record. 


The Set Random Record function causes the BDOS to automatically 
produce the random record position from a file whicn nas been read or 
written sequentially to a varticular point. The function can be 
useful in two ways. 


First, it is often necessary to initially read and scan a 
sequential fiie to extract the positions of various "key" fields. AS 
each key is encountered, function 36 is called to compute the random 
record position for the data corresponding to this key. If the data 
unit size is 128 bytes, the resulting record position is placed into a 
table with the key for later retrieval. After scanning the entire 
file and tabularizing the keys and their record numbers, you can move 
instantly to a particular keyed record by performing a random read 
using the corresponding random record number which was saved earlier. 
The scheme is easily generalized when variable record lengths are 
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involved since the program need only store the buffer-relative Dyte 
position along witn the key and record number in oraer to fina tne 
exact starting position of the keyed cata at a later time. 


A second use of function 36 occurs when switching from a 
sequential read or write over to random read or write. A file 1s 
sequentially accessed to a particular soint in tne file, function 35 
is called whicn sets the record number, and subsecuent random read and 
write operations continue from tne selected point in tne file. 


This section is concluded with a rather extensive, out complete 


| example of random access operation. Tne program listed below performs 


the simple function of reading or writing random records upon command 
W: ron the terminal, Given that tne program nas been created, 
assembled, ana placed into a file labelled RANDOM.COM, the CCP level 


_ command: 


RANDOM X,DAT 


starts the test oroaram. fhe orogram looks for a file by tne name 
X.DAT (in this oarticular case) and, if found, proceeds to oromot the 
console for input, If not found, the file is created before tne 
orompt is given. Each prompt takes tne form 


next command? 


and is followed by operator input, terminated by a carriage return. 
Tne inout commands take tne form 


nw nR Q 


where n is an integer value in the range Y to 65535, and 4, R, and Q 

ke simple command characters corresponding to random write, random 
read, and quit processing, respectively. If the w command is issued, 
tne RAHDOM program issues tne prompt 


tyoe data: 


The operator then resoonds by typing up to 127 characters, followed by 
a carriage return. RANDOM then writes the character string into the 
X.DAT file at record n. If the R command is issued, RANDOM reads 
record number n and displays the string value at the console. If the 
Q command is issued, the X.DAT file is closed, and the program returns 
to the console command processor. In the interest of brevity (ok, so 
the program's not so brief), the only error message is 


error, try again 


The program begins with an initialization section where the 
input file is opened or created, followed by a continuous loop at the 
label "ready" where the individual commands are interpreted, The 
default file control block at 285CH and the default buffer at 2080H 
are used in all disk operations. The utility subroutines then follow, 
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«hich contain tne princioal input line processor, called  "readc." 
[his particular program shows the elements of random access 
orocessing, and can be used as the basis for further program 


development. 


eRe PASSA EASA EES ANS CALERA SERA A RARA ER 


. & * 
é 

>* sample random access program for co/m 2.8 * 
. Kk * 


i 
eALERTS ROSA EE RENA ERAS RENACE RADNARA 


dlgd org ljan «Dase of toa 

dodo = repoot eau pad ¿system reboot 

Beds = pdos eau d8d5h ;Ddos entry point 

VvbD] = conin equ 1 «console input function 

0002 = conout equ à ¿Console output function 

DOES ostrina equ 9 sprint string until "p 

Bda = rstring eau ld “read console puffer 

dybe version eau 12 ¿return version number 

J00f = openf equ 15 «file open function 

2410 closef equ 16 ¿close function 

$016 = make É equ 22 make file function 

JuzZzl = r2aar equ 33 «read random 

4022 = writer edu 34 ¿Write random 

ó85cC = ECO eau àJ5cn «default file control block 

dv7d = ranrec eau feb+33 ¡random record oosition 

dd7f = ranovf equ fco*35  ;nigh order (overflow) byte 

vugd = Duff egu à2482h «buffer address 

pava = GE equ gan ;carriage return 

ó0ga = LI eau vah ;line feed 
RIO ROA RAR NARRAR 
„s * * 
;* load SP, set-up file for random access d 
a k * 
RR RE RR RRR ERR ER ER RRR ERR EERE EE 

8129 31bdc8 lxi SD,Stack 
A version 2.0? 

Jig3 Debe mvi c, version 

2105 cd9549 call bdos 

2108 fe26 cpi 24n «version 2.0 or better? 

vlja d2166 Jne versok 
; baa version, message and go back 

0lód lllbé lxi d,badver 

2118 cddas call orint 

2113 c3089 jmo reboot 


versok: 


. 
, 


correct version for random access 
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4116 
vllo 
allo 
gille 
llf 


4122 


.g1l24 


2127 
812a 
2120 


212e 


(131 


4134 


8137 
Bl3a 
013d 
4148 
3142 
8144 


$147 
08149 
gl4c 
g14£ 
2156 
8153 


0156 
0158 


gl5b 
2915e 
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den f 
115c0 
cd 56 
ic 
c2370 


gelo 
115c4 
codo 
3c 
c2370 


li3ag 
cadaé 
c3gdó 


cde5u 
227d8 
217£0 
3690 
fe5l 
c2564 


Geld 
ll5c4 
cda 58 
jc 
cab9Y 
c3090 


fe57 
c2890 


114d@ 
cddad 


~% woe 


* 


"9 =e "pp “se "o 


eady: 


wa “o FE Se ue 


ss t 


* 


ota: 


=e J =p *"9 "B "e. SE “ea 


mvi 
lxi 
call 
Int 
302 


cannot open fiie, 


mvi 
lxi 
cali 
inr 
252 


cannot create file, 
d,nospace 
orint 


Let 
call 
jmo 


c,oODeñf +oben default tcb 


ü.tco 
Daos 


a serr 
ready 


Zzero 


so create it 
c, make f 

da SECO 

odos 

a serr 255 
ready 


zero 


Sirectery full 


reocot ‘pack to cco 


*Xow o X X X Rx X RR OX X 0X EERE RARER X 0X X X OX X 0 Uo XX x xx X 


* 


* loop back to "reaay" after each command s 


* 


X OX XX X X 0& o Ko X KERR RRR X X 0X X X X X X X KEKE X x X X 0X AAA X ox 


fiie is ready for processing 


cail 
snid 
lxi 
mvi 
coi 
THz 


mvi 
lxi 
call 
inr 


readcom ;read next command 


ranrec store input record# 
n,ranovf 
m, «Clear high byte 1f set 
E ;gquit? 
notq 
quit processing, close file 
c,closef 
e PE aede 
bdos 
a err 255 becomes B@ 
error error message, retry 


12 
jmo 


not the quit command, 


reboot ¡back to ccp 


deco odd de od Re eo de OE OC ee OX XOU x ROCK IC X Ce X 


* 


* end of quit command, orocess write * 


* 


doo Ro de Ro CRX e CX RR KEKE ROC e RU e e X Xx 


random write? 


cpi 'W' 

jnz notw 

this is a random write, fill buffer until cr 
lxi d,datmsg 

call print :data prompt 


22 


dl6l 2e7Ef mvi Gola :up to 127 characters 


8163 213009 lxi n,Duff ¿destination 
— rloop: ¿read next character to buff 
#166 c> ousn D «save counter 
ài67 es pusn h «next destination 
v168 cac26 call getchr ;cnaracter to a 
— #160 el pop h ;restore counter 
vl6¢ ci UUD o "restore next to fill 
lod feud cpi ET «end of line? 
Blot ca?868 32 erlooo 
= : not end, store character 
24172 11] mov m,a 
8173 23 inx h ;next to fill 
4174 Ud acr C ¡counter goes down 
-- #175 C2500 jnz rloop send of buffer? 
t erloop: 
; end of read loop, store Je 
4173 36400 mvi n,@ 
: write the record to selected record number 
gl7a de22 mvi c,writer 
àl?7c 115c4 lxi d. feb 
^  $1?f cd850 call bdos 
Bld2 D? ora a «error code zero? 
dld3 c2b94 inz error ¿message if not 
él36 c3379 j mp ready >for another record 
A ARA RARA 
» * * 
:* end of write command, nrocess read * 


m »* * 
f 

CRRA EERE AKER XR AAA AAA 

, 


notw: 
: not a write command, read record? 
+ 8189 fe52 cpi 'R' 
818b c2b90 352 errot «Skip if not 
; read random record 
Jl8e 2e21 mvi c,readr 
8198 li5cé lxi O, CD 
0133 cd256 call bdos 
g196 D7 ora a «return code 24? 
9197 c2b98 jnz error 
; read was successful, write to console 
_. f$19a cdcf£e call crit “new line 
glya geð mvi c,128 max 128 characters 
d19f 21800 lxi h,buff ¿next to get 
wloop: 
—  1a2 7e mov a,m “next character 
Bla3 23 inx h snext to get 
glas e67f ani TER ;mask parity 
91a6 ca37e jz ready «for another command if 08 
g1a9 c5 push b ¿save counter 
Blaa e5 push h «save next to get 
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diab fe2d cpi eqraonic? 


diad d4cad enc putcnr ;skio output LÍ MOL 
lb el pOD h 
Ibl cl pop D 
152 d dcr È :countzcount-l 

à1b3 c2a26 nz wloop 

Bloé c337é6 3mp ready 
; 
T Pr LL CDM 
Za si 
.* end of read command, all errors end-u» here E 
* * 


C npn Ri ieee eae eee eee KR RUR eee SERS ET ELEN” 
, 


* 
t 


u etror: 

9103 11530 1xi d errmsg 

Bioe cadaé call orint 

9lIBE 03379 jm ready 
; 
RAT AAA, 
¿on * 
.* utility subroutines for console 1/0 * 
"Mei x 
; 


ÓN 


getchr: 
“read next console cnaracter to à 
Ble2 Vedl nvi c,conino 
àlc4 ca2540 call odos 
Bich c9 ret 
putcnr: 
“write character from a to console 
ülc8 0ev2 mvi c,conout 
olca 5f mov e,a «character to sens 
— ,@licd cdd5 call odos «send character 
Jlce cy ret 
CULOS 
“send carriage return line feed 
Qlcf 3ebd mvi act ¿carriage return 
vldl cdc88 call putcnt 
gJld4 3eda mvi alt “line feed 
-. $91d6 cdc80 call outchr 
91393 c9 ret 
print: 
sprint the buffet addressed by de until $ 
Vida d5 oush d 
dido cdcfé call crlf 
vide dl DoD | à ¿new line 
diaf 0eb9 mvi c,pstring 
dlel cd6059 call baos sorint the string 
dle4 c9 ret 


F 
readcom: 
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«read tne next command line to tne conbuf 


vle5 11604 lxi d,orompt 
gles cddaU cali print .connand? 
gleb veda mvi Cc, ESTELAS 
died 117a8 lxi d,conouf 
Qltfü ca805y call bdos :read command line 
; command line is present, scan it 
41£3 210428 lxi h,@ ¿start with 0009 
Z1£6 117c0 lxi d,conlin:command line 
Qlf9 la readc: Ildax 3 «next command cnaracter 
dlfa 13 inx d “to next command position 


Qltb b? ora a «Cannot oe end of command 
SALTS: ES cz 
: not zero, numeric? 
difd d634 Sul B 
Jltf fea cni 18 ¿Carry if numeric 
J20l 32134 jnc enard 
; add-in next digit 
J204 29 dac n AU 
Q285 4a mov ` ext 
020060 44 mov Dti ‘bc = value * 2 
0207 29 aad n E 
0260d 29 dad n sR 
0229 29 dad D **2 + *B8 = *1ld 
d2va 85 add Í :*digit 
J2u0 OF TOV l,a 
220C a2tyd JNE reaóc ;for anotner char 
d2df 24 inr n :overflow 
4219 c3f30 jmo readc ;for another char 
enaárd: 
: end of read, restore value in a 
0213 c630 adi y! . command 
3215 febl col ta! stranslate case? 
3217 OG ES 
: lower case, mask lower case bits 
0218 eo5f ani 141511115 
021a c9 ret 


ook Kok Kok OW Ko ode X OK XX KR UX XO OX 000 HO XXX XXX OX 0e 0X XX 0X0 x K 


* x 


* string data area for console messages d 
. * * 


WREAK KEKE RRR KER EKER EK E 


f 
; 
t 
; 
Dadver: 


d2lb 536f79 db ‘sorry, you need co/m version 2$' 
nospace: 
023a 4e6f29 do 'no directory spaces” 
datmsg: 
24d 5473760 do ‘type data: 3j' 
errmsg: 
4259 457272 db . "error, try again.s' 
promot: i 
0260 4e6570 db ‘next commana? $' 


. 
Li 
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IRENE 
, 
. x * 
f 

z cad. moms L 
:* Fixed and variable data area * 
. Y * 


, 
RRR KEKE RHEE ROCCO HONOR HC ROC AAA AEREA 
f 


827a 21 conbuf: db conlen ;lenath of console buffer 
827b consiz: ds l «resulting size after reao 
927c conlin: ds 32 “length 32 buffer 
0621 = conlen equ $-consiz 
y29c as 32 :16 ievel stack 
stack: 
| dà2bc end 
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Ug. CP/M 2.29 MEMO: JRGOAWIZALT ion. 


Similar to earlier versions, CP/M 2,0 1S fielad-altered to fit 

jene memory Sizes, deoending uzon the nost computer memory 

configuration. Typical pase addresses for popular memory sizes are 
snown in the taole melow, 


| Module 20k 24k 32% 43 64k 
CC 34004 440 dH 6499H A490H E400H 
BDOS 3Co 0H 4CJ JH TEE ACUUR ECU SH 
BIOS Ad òH SAU OH 7AJ dt SAUUH FAd dH 
roo of Ram 4f Fra sper ¿PERA BFEFEFH PEREA 


The aistribution disk contains a CP/M 2.0 System configured for a 28K 


Intel MOS<-880 witn standard laM d" floppy disk drives. The disk 
layout is shown below: 
^m 
sector Prack Yu Moaule Prack dl Module 
l (30ortstrap Loader) 408JH 3DOS + 430H 
3400H CCP + d0uH 41Y4H BDOS + 5640H 
3 33007 CCP + UsdH 410909H 3D0S + 580H 
4 3>3dunA CCP + 101 420688 3DOS + 6008 
3 33303 CCP + ldt 42348 BDOS + 630d 
6 Jodun CCP + 290 43óud BDOS + 700H 
7 sodden CCP + 29045 33341 BDOS + 780H 
5 jijo. CCP + 3udn 44043 3D05 + 80H 
2 37 odd CCP + 3ddd á480d BDOS + 88UH 
l4 360ud ccp + 4à8H 450vH BDOS + 98H 
l4 3ddod CCP + 48uHA 43308 BDOS + 98dH 
i, 12 39dug8 CCP + 5098H 4604H BDOS + ABOH 
i3 39ddH CCP + 58H 4680H BDOS + A8QH 
. 14 3A00H CCP + 60H 4709H BDOS + BOOH 
19 3486e CCP + 68H 4780H BDOS + BƏH 
l6 380 dH Cccp + 738d 48@0H BDOS + COBH 
I 3383H CCP + 7828 48808 BDOS + C80H 
— 18 3cóüH BDOS + OOH 49008 BDOS + DOGA 
19 3caüH BDOS + 0B80H 4980H BDOS + D30H 
29 30084H BDOS + 100K 4A00H BIOS + 4004 
21 3089H BDOS + 1d0H 4A80H BIOS + JEH 
22 380084 BDOS + 200H 4800H BIOS + 1001 
23 3E80H BDOS + 280K 48808 BIOS + 1884 
24 3F0%H BDOS + 3284 ACOH BIOS + 208H 
25 3FY9H BDOS + 380% 4Ca8H BIOS + 2808 
26 4000H BDOS + 40¥8H 40004 BIOS + 3905 
In particular, note that the CCP is at the same position on the disk, 
and occupies the same space as version 1.4. The BDOS portion, 
however, occupies one more 256-byte page and the BIOS portion extends 
through the remainder of track Ol. Thus, the CCP is 88H (2048 


decimal) bytes in length, the BDOS is EH (3584 decimal) bytes in 
length, and the BIOS is up to 380H (898 decimal) bytes in length. In 
version 2.8, the BIOS portion contains the standaró subroutines of 
1.4, along with some initialized table space, as described in the 
following section. 
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10. BIOS DIFFERENCES. 


The CP/M 2.0 Basic I/O System differs only slightly in concent 
from its predecesssors. Two new jum? vector entry points are defined, 
a new sector translation subroutine is included, and a disk 
characteristics table must be defined. Tne skeletal form of these 
- changes are found in the program shown below. 


At org 4020h 
24 maclio diskdet 
Le 3mo boot 
di 3 cis 
23 jmp listst :list status 
6: jmp sectran ;sector translate 
23 disks 4 
ge large capacity drive 
9: DpD eau 16*1224 :bvtes per block 
10: rpb equ ppo/l26 ¡records per Diock 
1i: maxb equ 65535/roo ¿max block numoer 
12 diskdef 0,1,58,3,Dp0,maxb*1,128,2,2 
L4! diskdef 1,1,38,,0D0,maxp*1,128,0,2 
14: diskdef 2,4 
15: disxaef 3,1 
Los 3 
17: Doot: ret ; nOD 
E 
13: listst: xra a : noD 
20: ret 
24111 
22: seldsk: 
23: -drive number in C 
24: lxi n, -g228 in hl produces select error 
25: mov a.c sa is disk number Y ... ndisks-1 
| 26: coi ndisks ¡less than ndlsks? 

Y 27: rnc return with HL = @88@ if not 
28: 5 proper disk number, return dob element address 
29: mov lc 
3d: dad h EL 
3lI* dad h ;*4 
343 daa h :*g 
33: daa n c16 
34: Lxi d,dpbase 
157 dad d : HL=. dpd 
36: ret 
Jr d 
38: selsec: 

39 «sector number in C 

40: lxi h sector 

4&1: mov m,c 

42: ret 

43: : 

44: sectran: 

45: “translate sector BC using table at DE 
46: xchg ¿HL = „tran 

47: dad b «single orecision tran 
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gor 3 dad b again it double orecision tran 

439: TOV l,m :only low syte necessary nere 
5835-5 fill botn H and L if double orecision tran 
Dl ret ;HL = ??ss 

A 

53: sector: as i 

54: endef 

923 end 


Referring to the orogram shown above, lines 3-6 reoresent the 
BIOS entry vector of 17 elements (version 1.4 defines only 15 jumo 
vector elements). The last two elements orovide access Eo rhe 
"LISTST" (List Status) entry voint for DESPOOL. The use of tnis 
particular entry ooint 15 defined in the DESPOOL documentation, aná 1s 
no aifferent tnan the orevious 1,4 release, It snould oe noted that 
tne 1.4 DESPOOL orogram wiil not operate under version 2.4, Dut an 
undate version will oe available from Digital Research in tne neat 
future, 


Phe "SECTRAN" (Sector Number Translate) entry shown in tne jumo 
vector at line 6 provides access to a 310S-resident sector transiation 
subroutine. This mechanism allows tne uset to soecify the sector Skew 
factor and translation for a particular disk system, and is described 
below. 


A macro liorary is shown in tne listing, called DISKDEF, 
included on line 2, and referencea in 12-15. Altnough it is not 
necessary to use the macro library, 1t greatly simplifies tne dis« 
definition process, You must have access to tne MAC macro assembier, 
of course, to use the DISKDEF facility, while the macro library 15 
included witn all CP/M 2.8 distribution disks. (See the CP/M 2.8 
Alteration Guide for formulas wnicn you can use to hand-code tne 
tables produced by the DISKDEF library). 


A BIOS disk definition consists of the following sequence of 
macro statements: 


MACLIB DISKDEF 
DISKS n 
DISKDEF JU,... 
DISKDEF 1,... 
OISKDEF n-l 


> è 9 b * e 


ENDEF 


where the MACLI3 statement loads the DISKDEF.LIS file (on the same 
disk as your 3I0S) into MAC'S internal tables, The DISKS macro call 
follows, which specifies the number of drives to be configured with 
your system, where n is an integer in the range 1 to 16. A series of 
OISKDEP macro calls tnen follow which define the characteristics of 
each logical disk, Y through n-l (corresvonding to logical drives A 
through P). Note that tne DISKS and DISKDEF macros generate in-line 
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fixed data tables, and tnus must pe olaced in a non-executaole cortion 
of your BIOS, typically directly following tne DIOS jump vector. 


The remaining portion of your 3105 is defined following the 
DISKDEF macros, with tne ENDES macro call immediately preceding the 
END Statement. Tne ENDEF (End of Disxdet) macro generates the 
necessary uninitialized RAM areas whicn are lecatea above your BIOS, 


The form of the DISKDEF macro call is 


DISKDEF dn,fsc,lsc,[s*fl,ols,dks,dir,cks,cfs,l0J| 


where 

dn is the logical disk number, U to n-i 

fsc is the first physical sector numoer (y or 1) 
a lsc is tne last sector numoer 

sKÉ is the optional sector skew factor 

pis is the data allocation olock size 

dift is the number of directory entries 

cks is the numoer of "cnecked" directory entries 

ots is the track offset to logical track dé 


[2] is an optional 1.4 compatibility flag 


The value "dn" is the drive number being defined witn this DISKDEF 
macro invocation, The "fsc" parameter accounts for differing sector 
numoering systems, and is usually Y or 1. The "lsc” is the last 
numbered sector on a track. When present, tne “skf” parameter defines 
the sector skew factor whicn is used to create a sector translation 
table according to the skew. If the number of sectors is less than 
256, a single-byte table is created, otherwise each translation table 
element occupies two bytes. No translation table is created if the 


skf parameter is omitted (or equal to b). The "bls" varameter 
specifies the number of bytes allocated to eacn data block, and takes 
on the values 1024, 2046, 4396, 8192, or 16334, Generally, 


Nberformance increases with larger data block sizes since there are 
fewer directory references and logically connected data records are 
physically close on the disk. Further, each directory entry addresses 
more data and the BIOS-resident cam space is reduced, The "dks" 
specifies the total disk size in "bls" units. That is, if the bls = 
2048 and dks = 1000, tnen the total disk capacity is 2,048,000 bytes. 
If dks is greater than 255, then the block size parameter bls must be 
greater than 1624, The value of "dir is the total number of 
directory entries which may exceed 255, if desired, The ""cks" 
parameter determines the number of directory items to check on each 
directory scan, and is used internally to detect changed disks during 
system operation, where an intervening cold or warm start has not 
occurred (when this situation is detected, CP/M automatically marks 
the disk read/only so that data is not subsequently destroyed). 
Normally the value of cks = dir when the media is easily changed, as 
is the case with a floppy disk subsystem. If the disk is permanently 
mounted, then the value of cks is typically à, since the probability 
of cnanging disks without a restart is quite low. the "ofs" value 
determines the number of tracks to skip when tnis particular drive iS 
addressed, which can be used to reserve additional operating system 
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pace or to simulate several logical drives on a single large capacity 

 ohysical drive. Finally. the [0] parameter is included when file 

compatibility is required with versions of 1.4 which have been 

y modified for highet density disks. inis varometel ensures that oniv 
6K is allocated for each directory record, as was the case for 
previous versions. Jormally, this varameter is not inciuded. 


For convenience and economy of table space, tne special for? 
DISKDEF 133 


gives disk i tne same characteristics as 4 previously defined drive d 
A standard four-drive single density system, which 1S compatible witn 
version 1.4, 15 defined using the following macro invocations: 
it, DISKS 4 
DISKDEF 0 
DISKDEF Ls 
DISKDEF PA 
DISKDEF 3 


/26,6,1024,243,64,64 2 


* .- * " 


ENDEF 


with all disKs having the same parameter values of 26 sectors oer 
track (numpered ] through 26), with 6 sectors skipped between each 
access, 1024 bytes per data DIOCK, 243 data plocks for a total of 243k 
byte disk capacity, 94 checked directory entries, and two operating 
system tracks. 


The definitions given in the program shown above (lines 12 

through 15) provide access to the largest disks addressable Dy CP/M 

2.0. All disks nave identical parameters, except that drives 0 and 2 
skip three sectors on every data access, while disks 1 and 3 access 

M acn sector in sequence as tne disk revolves (there may, however; be a 
transparent hardware Skew factor on these drives). 


The DISKS macro generates n "disk header DlOoCks," starting at 
address DPBASE which is a label generated py the macto. Each disk 
header block contains sixteen bytes, and correspond, in sequence, tO 
each of the defined drives. In tbe four drive standard system, for 
example, the DISKS macro generates a table of the form: 


DPBASE EQU $ 

DPE@: DW Sng, 0000H, 0000H, 00008  DIRBUF -DP33,CSVO- ALS 
DPEl: DW oa 0000H,00008.DIRBUF ,DPBO CSV. EU. 
DPEZ2: DW a OOOH 00h, DIRBUF ,DPBB CSV Z ALS 
DPE3: DW ALTO OO 00008, 00008, DIRBUE ,DPBO , CSV3 AV? 


where the DPE (disk parameter entry) labels are included for reference 
purposes to show the beginning table addresses for each drive 2 
through 3. The values contained within the disk parameter header are 
described in detail in the CP/M 2.8 Alteration Guide, but basically 
address the translation vector for the drive (all reference XLT@, 


J which is the translation vector for drive @ in the above example), 
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followed Dy tnree ló-bit “scratch” addresses, followed oy the 
directory buffer address, disk parameter block address, cneck vector 
address, and allocation vector address. The check and allocation 
vector addresses are generated by the ENDEF macro in the ram area 
following the BIOS code and tables, 


The SELDSK function is extended somewhat in version 2,0, In 
particular, the selected disk number is passed to tne BIOS in register 
C, as before, and the SELDSK subroutine performs the appropriate 
software or hardware actions to select tne disk, Version 2.4, 
however, also requires the SELDSK subroutine to return the adúress of 
the selected disk parameter header (DPEO, DPEl, DPE2, or DPE3, in the 
above example) in register HL. If SELD»sK returns the value HL = 
2060H, then the BDOS assumes tne disk does not exist, anda prints a 
select error mesage at tne terminal. Program lines 22 through 36 give 
a sample CP/M 2.0 SELDSK subroutine, showing only the disk parameter 

Eader address calculation. 


The subroutine SECTRAN is also included in version 2.0 which 
performs tne actual logical to pnysical sector translation. In 
earlier versions of CP/M, the Sector translation process was a part of 
tne BDOS, and set to skip six sectors between each read. Due 
differing rotational speeds of various disks, the translation function 
has become a art of the 8105 in version 2.4. Thus, the apOS sends 
sequential sector numbers to SECTRAN, starting at sector numoer Ü. 
The SECTRAN suoroutine uses the sequential sector number to produce à 
translated sector number which is returned to tne BDOS. Tne  8DOS 
supseauently sends the translated sector numper to SELSEC pefore the 
actual read or write is performed, Note that many controllers have 
the capability to record the sector skew on the disk itself, and thus 
there is no translation necessary. In this case, the "skf" parameter 
is omitted in the macro call, and SECTRAN simply returns the same 
value which it receives. The table snown below, for example, is 
constructed when the standard skew factor skf = 6 is specified in the 
DISKDEF macro call: 

R XLT@: DB 1,7,13,19,25,5,11,17,23,3,9,15,21 
DB 2.8,14,20,26,6,12,18,24,4,10,16,22 


If SECTRAN is required to translate a sector, then the tollowing 
process takes place. Tne sector to translate is received in register 
pair BC. Only the C register is significant if the sector value does 
not exceed 255 (B = 09 in this case). Register pair DE addresses the 
sector translate table for this drive, determined by a previous Call 
on SELDSK, corresponding to the first element of a disk parameter 
header (XLTÜ in the case snown above). The SECTRAN subroutine then 
fetches the translated sector number oy adding tne input sector number 
to tne base of tne translate table, to get the indexed translate table 
address (see lines 46, 47, and 48 in the above program). The value at 
this location is then returned in register L. Note that if the number 
of sectors exceeds 255, the translate table contains 16-bit elements 
whose value must be returned in HL. 


Following the ENDEF macro call, a number of uninitialized data 
areas are defined. Tnese data areas need not be a part of the BIOS 
(All Information Contained Herein is Proprietary to Digital Research.) 


x2 


wnicn is loaded upon cold start, but ñ 


Must pe avaliatle between the 
BIOS ana tne ena of memory, Ihe size ot tne uninitialized PAM area 1s 
determined oy EJU statements generated by tne ENDEP macro, For a 


standard fourearive cyston, tne ENDEF macro miant vroauce 


4072 


BESDAS EQU 5 
(data areas) 
403% = ENDDAT EQu 3 
JISC DATSIZ EQU $S-a3EGDATD 


whicn indicates tnat uninitialized RA oegins at location 4C72H, ends 
at 4DBOH-l, ana occupies Jl3Ci D7/te3, You must ensure tnat enese 
aadresses are free for use after tne system 1s loaded, 


CP/M 2.0 is also easily adapated to disk subsystems whose sector 
Size is a multiple of 12d bytes. Information is orovided by the BOOS 
A sector write operations which eliminates tne need for ore-read 


O, Cations, thus allowing olocking and deblocking to taxe place at tne 
BIOS level. 


see tne “CP/M 2.0 Alteration guide" for additional details 
concerning tailoring your CP/M System to your particular nardware, 
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ED USER'S MANUAL. 


ls ED TUTORIAL 
l.l. Introduction to ED. 


ED is the context editor for CP/M, and is used to create 
and alter CP/M source files. ED is initiated in CP/M by 


typing 


«filename»? 
ED 
<filename>.<filetype> 


In general, ED reads segments of the source file given by 
<filename> or <filename> . <filetype> into central memory, 
where the file is manipulated by the operator, and subse- 
quently written back to disk after alterations. If the 
source file does not exist before editing, it is created by 
ED and initialized to empty. The overall operation of ED 
is snown in Figure 1. 


1.2. ED Operation 


ED operates upon the source file, denoted in Figure l1 
by x.y, and passes all text through a memory buffer where 
the text can be viewed or altered (the number of lines which 
can be maintained in the memory buffer varies with the line 
length, but has a total capacity of about 6000 characters 
in a 16K CP/M system). Text material which has been edited 
is written onto a temporary work file under command of the 
operator. Upon termination of the edit, the memory buffer 
is written to the temporary file, followed by any remaining 
(unread) text in the source file. The name of the original 
file is changed from x.y to x.BAK so that the most recent 
previously edited source file can be reclaimed if necessary 
(see the CP/M commands ERASE and RENAME). The temporary 
file is then changed from x.$$$ to x.y which becomes the 
resulting edited file. 

The memory buffer is logically between the source file 
and working file as shown in Figure 24 


1.3. Text Transfer Functions 


Given that n is an integer value in the range 0 through 
65535, the following ED commands transfer lines of text 
from the source file through the memory buffer to the tem- 
porary (and eventually final) file: 


Figure l. Overali ED Operation 
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Libraries 


Source Append Write 
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Memory Buffer 
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Note: the ED program accepts both lower and upper case ASZIT 
characters as input from the console. Single letter commands 
can be typed in either case. The U command can be issued to 
cause ED to translate lower case alphabetics to upper case as 
characters are filled to the memory buffer from the console. 
Characters are echoed as typed without translation, however. 
The -U command causes ED to revert to "ho translation” mode. 


ED starts with an assumed -U in effect. 
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Figure 2. Memory Buffer Organization 
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Figure 3. Logical Organization of Memory Buffer 
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nA<cr>” - append the next n unprocessed source 
lines from the source file at SP to 
the end of the memory buffer at MP. 
Increment SP and MP by n. 


nW«cr» - write the first n lines cf the memory 
buffer to the temporary file free space. 
Shift the remaining lines n+l through 
MP to the top of the memory buffer. 
Increment TP by n. 


E<cr> - end the edit. Copy all buffered text 
to temporary file, and copy all un- 
processed source lines to the temporary 
file. Rename files as described 
previously. 


H«cr» - move to head of new file by performing 
automatic E command. Temporary fiie 
becomes the new source file, the memory 
buffer is emptied, and a new temporary 
file is created (equivalent to issuing 
an E command, followed by a reinvocation 
of ED using x.y as the file to edit). 


O<cr> - return to original file. The memory 
buffer is emptied, the temporary file 
id deleted, and the SP is returned to 
position l of the source file. The 
effects of the previous editing commands 
are thus nullified. 


Q«cr^ - quit edit with no file alterations, 
return to CP/M. 


There are a number of special cases to consider. If the 
integer n is omitted in any ED command where an integer is 
allowed, then 1 is assumed. Thus, the commands A and W append 
one line and write 1 line, respectively. In addition, if a 
pound sign (+) is given in the place of n, then the integer 
65535 is assumed (the largest value for n which is allowed). 
Since most reasonably sized source files can be contained 
entirely in the memory buffer, the command #A is often issued 
at the beginning of the edit to read the entire source file 
to memory. Similarly, the command #W writes the entire buffer 
to the temporary file. Two special forms of the A and W 


p (nd 
*<cr> represents the carriage-return key 


commands are provided as a convenience. The command 0A fills 
the current memory buffer to at least half-full, while OW 
writes lines until the buffer is at least half empty. It 
should also be noted that an error is issued if the memory 
buffer size is exceded. The operator may then enter any 
command (such as W) which does not increase memory require- 
ments. The remainder of any partial line read during the 
overflow will be brought into memory on the next successful 


append. 
1.4. Memory Buffer Organization 


The memory buffer can be considered a sequence of source 
lines brought in with the A command from a source file. The 
memory buffer has an associated (imaginary) character pointer 
CP which moves throughout the memory buffer under command of 
the operator. The memory buffer appears logically as shown 
in Figure 3 where the dashes represent characters of the 
source line of indefinite length, terminated by carrlage- 
return («cr») and line-feed («1f») characters, and 
represents the imaginary character pointer. Note that the 
CP is always located ahead of the first character of the 
first line, behind the last character of the last line, or 
between two Characters. The current line CL is the source 
line which contains the CP. 


1.5. Memory Buffer Operation 


Upon initiation of ED, the memory buffer is empty (ie, 
CP is both ahead and behind the first and last character). 
The operator may either a end lines (A command) from the 
source file, or enter the nes directly from the console 
with the insert command 


I«cr? 


ED then accepts any number of input lines, where each line 
terminates. with a «cr» (the «lf» is supplied automatically), 
until a control-z (denoted by tz is typed by the operator. 
The CP is positioned after the last character entered. The 
sequence | 


I<¢cr? 

NOW IS THE*Cr? 
TIME FOR<cr? 

ALL GOOD MEN<cr? 
tz 


leaves the memory buffer as shown below 


«nT<cr> - If n=0 then type the contents of the 
current line up to CP. If n=l then 
type the contents of the current line 
from CP to the end of the iine. If 
n^] then type the current line along 
with pel lines which follow, if + 
is specified. Similarly, if n>l and 
- is given, type the previous n lines, 
up to the CP. The break key can be 
depressed to abort long type-outs. 


-n«cr» - equivalent to :nLT, which moves up Or 
down and types a single line 


1.6. Command Strings 


Any number of commands can be typed contiguously (up to 
the capacity of the CP/M console buffer), and are executed 
only after the «cr» is typed. Thus, the operator may use 
the CP/M console command functions to manipulate the input 
command: 


Rubout remove the last character 
Control-U delete the entire line 
Control-C re-initialize the CP/M System 
Control-E return carriage for long lines 


without transmitting buffer 
(max 128 chars) 


Suppose the memory buffer contains the characters shown 
in the previous section, with the CP following the last 
character of the buffer. The command strings shown below 
produce the results shown to the right 


Command String Effect Resulting Memory Buffer 
la. B2T<CI> move to beginning ep o" IS THE«cr»«1lf» 
of buffer and type TIME FOR<cr><lf> 
2 lines: 
"NOW IS THE ALL GOOD MEN<cr><lf> 
TIME FOR" 
2. 5c0T<cr> move CP 5 charac- NOW I S THE<cr><lf> 
ters and type the 


beginning of the 
line 
"NOW I" 


3. 2L-T<cr> move tw lines down NOW IS THE<cr’<lf? 
and type previous = 
ine TIME FOR<cr><l1f> 
"TIME FOR" ALL GOOD MEN«cr»«lf» 


4.  -LéK«cr? move up one line, NOW LS o a ee 
delte 65535 lines (E 
which follow 
5, Iscr? insert two lines NOW IS THE«cr^*lf? 
TIME TO<cr? of text 
INSERT<cr> TIME TO<cr><lf> 


tz INSERT<er?<1£? “ep 


6. - ~2LéT<cr? move up two lines, NOW IS THE<er><1£? AD] 


and type 65535 
lines ahead of CP TIME POLETE 


"NOW IS THE” INSERT<cr><lf> 
T. GI? move down one line NOW IS THE<cr><1f> 
and type one line 
"INSERT" TIME TO«er»lf? Cp) 
INSERT<cr><lf> 


1.7. Text Search and Alteration 


ED also has a command which locates strings within the 
memory buffer. The command takes the form 


«cr» 
i3 >. b» 


where cy through Ck represent the characters to match followed 
by either a «cr» or control -Z - ED starts at the current 
position of CP and attempts to match all k characters. The 
match is attempted n times, and if successful, the CP is 

moved directly after the character Cy: If the n matches are 
not successful, the CP is not moved rom its initial position. 
Search strings can include tl (control-1), which is replaced 
by the pair of symbols <er><1f>. 


REM. e ' 
*The control-z is used if additional commands will be typed 
following the tz. 


The following commands iliustrate the use of the F 
command: 


Command String Effect Resulting Memory Buffer 
1. B#T<cr> move to beginning a NOW IS THE<cr><lf> 
and type entire 
buffer TIME FOR«cr»«1f» 
ALL GOOD MEN<cr><1f> 
2. FS Ter find the end of NOW IS a 
the string "S T" 
3. FI*zUÜTT find the next "I" NOW IS THE<cr><lf> 
and type to the 
CP then type the TI (QU POR<cr><l£> 
remainder of the ALL GOOD MEN<cr><lf> 
current line: 
"TIME FOR” 


An abbreviated form of the insert command is also allowed, 
which is often used in conjunction with the F command to make 
simple textual changes. The form is: 


"o ws GOLES or 
I e 2 n 


oC: 6.454: Qo Sere 
I €1€5 z 


where cj through c, are characters to insert. If the inser- 
tion string is terminated by a +z, the characters cy through 
Cp are inserted directly following the CP, and the CP is 
moved directly after character Cg. The action is the same 
if the command is followed by a «cr? except that a <cr><lf> 
is automatically inserted into the text following character 
cg. Consider the following command sequences as examples 

of the F and I commands: 


Command String Effect Resulting Memory Buffer 
BITHIS IS tz<cr> Insert "THIS IS " THIS IS NOW THE <cr><lf> 
at the beginning | 
of the text 


TIME FOR<cr><1£> 
ALL GOOD MEN<cr><1f? 


FTIME*z-ADIPLACE*z«cr^ 


and delete 


find "TIME 
= “PLACE: 


insert 


3FO*2- 3DS5DICHANGES*+<CI> 


find third occurrence 
of "O" (ie the second 
"0" in GOOD), delete 

previous 3 characters; 
then insert "CHANGES" 


move back 8 characters 
and insert the line 
"SOURCE<cr><1f>" 


-8CISOURCE<¢r> 


ED also provides a single command 


I commands to perform simple string substitutions. 


COT X 
tz 


takes the form 


n S C1€5: e tZ "NI 


THIS IS NOW THE*cr?^:1f»? 
PLACE FOR<cr><1f> 
ALL GOOD MEN<cr><1f> 


THIS IS NOW THE <cr><lf> 
PLACE FOR<cr><lf> 
ALL SHANGEB E EUST 


THIS IS NOW THE<cr><1f> 
PLACE FOR<cr><1f> 
ALL SOURCE<¢r><it? 


[CB PRESSES 


which combines the F and 


The command 


and has exactly the same effect as applying the command string 


i 


a total cf n times. 
starting at the current 


stitutes the second string for the first string 


Fc Ca++ LEV t2-kDId d, d ( 


<er>? 


tz 


That is, ED searches the memory buffer 
position of CP and successively sub- 


until tne 


end of buffer, or until the substitution has been performed 


n times. 
As a convenience, 


a commanå similar to F is provided by 


ED which automatically appends and writes lines as the search 


The form is 


cr 
n N Cy Sar Sy (5) 


proceeds. 


which searches the entire source file for 
(recall that F fails if the string 


of the string CiC2.-.Ck 
cannot be found in the current buffer). 
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the nth occurrence 


The operation of the 


4 command is precisely the same as F except in the case tnat 
the string cannot be found within the current memory buffer. 
In this case, the entire memory contents is written (ie, an 
automatic 4W is issued). Input lines are then read untii 
the buffer is at least half full, or the entire source file 
is exhausted. The search continues in this manner until the 
string has been found n times, or until tne source file nas 
been completely transferred to the temporary file. 

A final line editing function, called the juxtaposition 
command takes the form 


- : n Cor? 
nal CCCat €, 77 d,d,---d.°2 ha eine es 


with the following action applied n times to tne memory buffer: 
search from the current CP for the next occurrence of the 
string CjC5.-.-Ck- If found, insert the string Ayda. +- Ôh? 

and move c$ to follow dg. Then delete all characters following 
CP up to (but not including) the string ej;8e2:;--:-:9q' leaving 

CP directly after Cm: If e] ,e2»-»»2 cannot be found, then 

no deletion is made. If the current line 1s 


RM IS THE TIME<Cr><1f£> 


Then the command 
JW +*zWHAT*zZ+1<CI> 


Results in 


NOW WHAT E] <cr><1f> 


(Recall that ^l represents the pair <cr><lf> in search and 


substitute strings). 
It should be noted that the number of characters allowed 
by ED in the F,S,N, and J commands is limited to 100 symbols. 


1.8. Source Libraries 


ED also allows the inciusion of source libraries during 
the editing process with the R command. The form of this 
command is 


RB f.f.sottz Or 


R fif, -£ 9er? 


where £,f5.-f, is the name of a source file on the disk with 
as assumed filetype of ‘LIB’. ED reads the specified file, 
and places the characters into the memory buffer after CP, 
in a manner similar to the I command. Thus, if the command 


RMACRO«cr? 


is issued by the operator, ED reads from the file MACRO.LIB 
until the end-of-file, anc automatically inserts the charac- 
ters into the memory buffer. 


1.9. Repetitive Command Execution 


The macro command M allows the ED user to group ED com- 
mands together for repeated evaluation. The M command takes 


the form: 
«cr»? 
n M Cp Sar Ek ad 


where CjC2...Cy represent a string of ED commands, not inclu- 
ding another M command. ED executes the command string n 
times if n>l. If n=0 or 1, the command string is executed 
repetitively until an error condition is encountered (e.g.; 
the end of the memory buffer is reached with an F command). 
As an example, the following macro changes all occur- 
rences of GAMMA to DELTA within the current buffer, and 
types each line which is changed: 


MFGAMMA^z-5DIDELTA*zÜOTT«cr? 


or equivalently 


MSGAMMAtzDELTAtzOTT<cr? 
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2. ED ERROR CONDITIONS 


On error conditions, ED prints the last character read 
before the error, along witn an error indicator: 


? unrecognized command 


> memory buffer full (use one Of 
the commands D,K,N,S, or W to 
remove characters), F,N, or S 
strings too long. 


4 cannot apply command the number 
of times specified (e.g., in 
F command) 


O cannot open LIB file in R 
command 


Cyclic redundancy check (CRC) information is written with 
each output record under CP/M in order to detect errors on 
subsequent read operations. If a CRC error is detected, CP/M 
will type 


PERM ERR DISK d 


where d is the currently selected drive (A,B,...). The oper- 
ator can choose to ignore the error by typing any character 
at the console (in this case, the memory buffer data should 
be examined to see if it was incorrectly read), or the user 
can reset the system and reclaim the backup file, if it 
exists. The file can be reclaimed by first typing the con- 
tents of the BAK file to ensure that it contains the proper 
information: 


TYPE x.BAK<Cr> 


where x is the file being edited. Then remove the primary 
file: | 


ERA x.y<cr? 
and rename the BAK file: 
REN x.y-x.BAK«cr? 


The file can then be re-edited, starting with the previous 
version. 


is 


and 


CONTROL CHARACTERS AND COMMANDS 


The following table summarizes the control characters 
commands available in ED: 


Control Character Function 

te system reboot 

te physical <cr><1f> (not 
actually entered in 
command) 

ae legical tab (cols lH 
logs.) 

L logical <cr><lf> in 
search and substitute 
strings 

£u line delete 

ez string terminator 

rubout character delete 
break discontinue command 


(e.g., stop typing) 


l4 





nF 


nz 


+n<cr> 


Tonetion 
append lines 
begin bottom of buffer 
move character positions 
delete characters 


end edit and close files 
(normal end) 


find string 


end edit, close and reopen 
files 


insert characters 

place strings in juxtaposition 
kill lines 

move down/up lines 

macro definition 


find next occurrence with 
autoscan 


return to original file 
move and print pages 

quit with no file changes 
read library file 
substitute strings 


type lines 


translate lower to upper case if U, 
no translation if -U 
write lines 


sleep 


move and type ( £nLT) 
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Appendix A: ED 1.4 Enhancements 


The ED context editor contains a number of commands which enhance its 
usefulness in text editing. The improvements are found in the addition of line numbers, 
free space interrogation, and improved error reporting. 


The context editor issued with CP/M 1.4 produces absolute line number prefixes 
when the "V" (Verify Line Numbers) command is issued. Following the V command, 
the line number is displaved ahead of each line in the format: 


nnnnn: 


where nnnnn is an absolute line number in the range 1 to 65535. If the memory buffer 
is empty, or if the current line is at the end of the memory buffer, then nnnnn appears 
as 5 blanks. 


The user may reference an absolute line number by preceding any command by 
a number followed bv a colon, in the same format as the line number display. In this 
case, the ED program moves the current line reference to the absolute line number, 
if the line exists in the current memory buffer. Thus, the command 


345:T 


is interpreted as "move to absolute line 345, and type the line." Note that absolute 
line numbers are produced onlv during the editing process, and are not recorded with 
the file. In particular, the line numbers will change following a deleted or expanded 
section of text. 


The user may also reference an absolute line number as a backward or forward 
distance from the current line bv preceding the absolute line number by a colon. Thus, 
the command 


:400T 


is interpreted as "tvpe from the current line number through the line whose absolute 
number is 400," Combining the two line reference forms, the command 


345::400'T 
for example, is interpreted as "move to absolute line 345, then type through absolute 
line 490," Note that absolute line references of this sort can precede any of the 
standard ED commands. 


A special case of the V command, "^V", prints the memory buffer statistics in 
the form: 


free/total 


where "free" is the number of free bytes in the memory buffer (in decimal), and "total" 
is the size of the memory buffer. 


ED 1.4 also includes 8 "block move" facility implementec through the "X" (Xfer) 
command. The form 


nx 
transfers the next n lines from the current line to a temporary file called 
X$5$$$$ $.LIB 


which is active on!y during the editing process. [n general, the user can reposition 
the eurrent line reference to anv portion of the source file and transfer lines to the 
temporary file. The transferred line accumulate one after another in this file, anc 
can be retrieved by simply typing: 


R 


which is the trivial case of the library read command. In this case, the entire 
transferred set of lines is read into the memory buffer. Note that the X command 
does not remove the transferred lines from the memory buffer, although a K command 
can be used directly after the X, and the R command does not empty the transferred 
line file. That is. given that a set of lines has been transferred with the X command, 
they ean be re-read any number of times back into the source file. The commanó 


ax 
is provided, however, to empty the transferred line file. 

Note that upon normal completion of the ED program through Q or E. the 
temporary LIB file is removed. If ED is aborted through ctl-C, the LIB file will exist 
if lines have been transferred, but will generally be empty (a subsequent ED invocation 
will erase the temporary file). 


Due to common typographical errors, ED 1.4 requires several potentially disas- 
terous commands to be typed as single letters, rather than in composite commands. 
The commands 


E (end), H (head), O (original), Q (quit) 
must be typed as single letter commands. 
ED 1.4 also prints error messages in the form 
BREAK "x" AT e 


where x is the error character, and c is the command where the error occurred. 
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l.  CP/M-86 SYSTEM OVERVIEW 


This document presents the system orogramming aspects of 
CP/M-86, a single-user operating svstem fcr the intei 8086 and 
compatible 5088 i6-Dit micrsocrocessors. The discussion assumes 
basic familiarity with CP/M-80, the Digital Research g-bit 
operating system, and oresents an overview of CP/M-86 oroqram 
interface conventions and adaptation procedures. CP/M-80 and CP/M- 
86 are equivalent at the user interface level and thus the Digital 
Research manuals 


An Introduction to CP/M Features and Facilities 
2D: A Context Editor for the CP/M Disk System 
CP/M 2 User's Guide 


along with the ASM86 and DDTS6 User's Guides, which accompany this 
manual, should be referenced for further definitions and operating 
details. This document, in effect, reviaces the CP/M 2 Interface 
Guide and CP/M 2 Alteration Guide for operation of C?/M with the 
3086 and 8088 processors. 


l.l.  CP/M-86 General Characteristics. 


CP/M-86 contains all facilities of CP/M-80 with additional 
features to account for increased processor address space of up to 
a megabyte (1,048,576) cf main memory. Further, CP/M-36 maintains 
file compatibility with all orevious versions of CP/M. The file 
structure of version 2 cf CP/M is used, allowing as many as sixteen 
drives with up to eight megabytes on each drive. Thus, CP/M-80 and 
CP/M-86 files are completely interchangeable. 


CP/M-86 resides in the file CPM.SYS which is loaded into 
memory by a Cold start loader during system initialization... Tne 
cold start loader itself resides on the first two tracks of the 
system disk. CPM.SYS contains three orogram modules: the Console 
Command Processor (CCP), the Basic Disk Operating System (BDOS), 
and user-configurable Basic I/O System (BIOS). The CCP and BDOS 
portions occupy approximately 1LOK bytes, while the size of the 3105 
varies with the implementation. The overating svstem executes CA 
any portion of memory above the reserved interrupt locations, while 
ene remainder of the address soace is oartitioned into as many as 
eight non-contiguous regions, as defined in a BIOS table. "nlixe 
CP/M-80, the CCP area cannot be used as a data area subsegdguent to 
transient 2rogram load: the CCP, BDOS, and BIOS remain in memorv at 
all tines, and are not reloaded upon each warm start. 


Similar to C?/M-30, CP/M-86 loads and executes memor" imace 
files from disk. Memory image files are preceded by a "header 
record," “efined in this document, which crtovides information 
required for proper program loacing and executicn. Memory image 
files under CP/M-86 are identified tv a "CMD" file tvoe. 
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CP/M-86 General Characteristics Se 


Unlike C2/M-80, CP/M-86 does not use absolute locations tor 
system entry ot default variables. The BDOS entry takes Dlace 
through a software interrupt, while entry to the BIOS is orovided 
by a new BDOS call. Two variables maintained in low memory under 
CP/M-80, the default disk number and I/O Byte, are olaced in the 
CCP and B7^S, respectively. The final ¿denendence unan abcoluce 
addresses is removed in CP/M-86 by maintaining initial “base sage” 
values, such as the default FCB and default command buffer, in the 
transient program data area. 


Utility orograms such as ED, PIP, STAT and SUBMIT operate in 
-he same manner under CP/M-86 and CP/M-80. In its operation, DDTS6 
resembles DDT supplied with CP/M-80 but instead allows interactive 
debugging of 8086 and 8088 machine code. Similarlv, ASM86 allows 
assembly language programming and develooment for the 8086 and 8088 
mnemonics using the Intel format. The GENCMD (Generate CMD) 
utility replaces the LOAD program cf CP/M-80, and converts Intel 
8086 "hex" files into memory image format suitable for execution 
under CP/M-86. Further, the LDCOPY (Loader Coov) orogram renlaces 
SYSGEN, and is used to copy the cold start loader from a svstem 
disk for replication. In acdition, a variation of GENCMD, calied 
LMCMD, converts outout from the Intel Locate utilitv into MD 
format. Finally, GENDEF (Generate DISKDEF) is orovided as an aid 
in producing custom disk parameter tables. ASM86, GENCMD, UMCMD, 
and GENDEF are also supplied in "COM" file format for cross- 
develoument under CP/M-80. 


Several common abbreviations are used throughout this manual 
as defined below: 


Nibble 4-bit half-bvte 
Byte 8-bit value 

Word l6-bit value 

Double Word 32-bit value 
Paragraph 16 contiguous bytes 


Paragraph Boundary An address divisible evenly 
by 16 (low order nibole 0) 


Segment Up to 64 contiguous bytes 
Segment Register One of CS, DS, ES, or SS 
Offset l6-bit displacement from a 
seqment register 
Group A segment-recister-relative 
relocatable program unit 
Address The effective memory address 


derived from the composition 
of a segment register value 
with an offset value 


A group consists of a set of segments which are loaded into memory 
as a Single unit. Since a qrouo mav consist of more than 54K 
5vtes, it is the responsibility of tne anolication orcaram to 
manage segment registers when code or data beyond the first 54K 
secment is accessed. 
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1.2. Specific CP/M-80 and CP/M-86 Differencoz. 


The Structure of CP/M-86 is as close to CP/M-80 as possible 
in order to provide a familiar orocramming environment which ailows 
application programs to be transcoried to the 8086 and 8033 
processors with minimum effort. This section points out the 
svecific differences between CP/M-80 and CP/M-86 in order to reduce 
your time in scanning this manual if you are already familiar with 
CP/M. The terms and concepts oresented in this section are 
explained in detail throughout this manual, so you will need to 
refer to the Table of Contents to find relevant sections which 
orovide soecific definitions and i formation. 


Due to the nature of the 8086, the fundamental difference 
berween CP/M-80 and CP/M-86 is found in the management of the 
various relocatable groups. Although CP/M-80 references absolute 
memory locations by necessity, CP/M-86 takes advantage of the 
static relocation inherent in “he 8086 processor. The operating 
system itself is usually loaded directiy above the interruot 
locations, at location 0400R, and relocatable transient programs 
load directly above tne operating system. However, vou can load 
Cp/M-86 into any portion of memory without changing the operating 
system (thus, there is no MOVCPM utility with CP/M-86), and 
eransient programs will load aná run in any non-reserved region. 


Three general memory models are presented below, but if you 
are converting 8080 programs to CP/M-86, you can use either the 
8080 Model or Small Model and leave the Comoact Model for later 
when your addressing needs increase. You'll use GENCMD to sroduce 
an executable program file. When you verform vour conversion, 
ensure that you define a sufficiently larae data area to address 
-he last variable you access. You can do this in two ways. Place 
a "DB 0" at the end of your data area:  GENCMD detects chis loaded 
value and automatically determines the data area size. 
Alternatively, you Can explicitly tell GENCMD the data area size 
using the "data" kevword with an "M" (Minimum Memorv) value. 


CP/M-86 itself is constructed as an 8080 Model, although 
you^ll probably find the Small Model easier to use tor "our 
programs. This means that all the segment registers are olaced at 
-he base of CP/M-86, and vour customized BIOS is identical, in most 
respects, to that of CP/M-80 (with changes in instruction 
mnemonics, of course). In fact, the only additions are found in 
the SETSEGB, GETSEGB, SETIOB, and GETIOB entry points in the BIOS. 
Your warm start subroutine is simpler since you are not required to 
reload the CCP and 3DOS under CP/M-86. One other point: if you 
implement the IOBYTE facility, you'll have to define the variable 
in vour BIOS. Taking these changes into account, You need only 
perform a simple translation of vour CP/M-80 BIOS into 3086 code in 
order to implement your new BIOS. 


If vou’ve implemented CP/M-80 version 2, you already have 
disk definition tables which will operate prooerl" with C9/M-B86. 
You may wish to attach different disk drives, Or experiment wich 
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sector skew factors to increase performance. If so, you can use 
the new GENDEF utility which performs tne same Function as the 
DISKDEF macro used by MAC under CP/M-80. You'll finc, however, 
that GENDEF orovides you with more information and checxs error 
conditions better than the DISKDES macro. 


System generation is simpler than CP/M-80, but you lii have to 
perform a two-sted bootstrap load if vou want to operate witn 
single density floppy disks since CP/M-86 is too large to fit in 
the two track system area. First you loas tne cold start Loader, 
and the cold start loader loads CP/M-86. With tne exceotion of che 
BOOT entry coint, the cold start loader BIOS, called LD8BIOS, is 
identical to your CP/M-86 BIOS, alchough it can be simolified since 
no disk write operations take place. If vou reserve enough system 
-racks on a non-standard disk, vou can load CB/M-86 directly 
without the two-steo doot. 


BDOS entry is similar with the Substitution of a software 
interrupt under CP/M-86 for tne JMP 0025 found in CP/M-80. 
Although the JMP 0005 has been removed, the address field at offset 
0006 is present so that programs which "size" available memory 
usina this word value will operate without change. Entry and exit 
register names change, of course, but the cbvious substitutions 
have been made. Look through the list of 3DOS function numbers and 
you^ll find that functions Ô , 27, and 21 have changed siightiy. 
Several new functions have been added, but they do nct affect 
existing programs. 


Under CP/M-80, orograms terminate in one of three wavs: DY 
returning directly to the CCP, through BDOS function call 0, or 5v 
transferring control to absolute location 0000H. C?/M-86, however, 
supports only the first two methods of proaram termination. This 
has the side effect of not providing the automatic disk system 
reset following the jump to 00008 which, instead, is accomplished 
by entering a CONTROL-C at the CCP level. 


One major philosovhical difference is that in CP/M-80, all 
addresses sent to the BDOS are simply 16-bit values in the range 
0000H to OTFTTM. In CP/M-86, however, the addresses are really 
just l6-bit offsets from the DS (Data Seament) register which is 
set to the base of your data area. If you translate an existina 
CP/M-80 program to the CP/M-86 environment, your data segment will 
be less than 64K bytes. In this case, the DS register need not be 
changed following initial load, and thus all C?,/M-80 addresses 
become simple DS-relative offsets. 


You”11 find many new facilities in CP/M-85 chat will simplify 
your programming and exoand your apolication orogramming 
capability. But, we've designed CP/M-86 to make it easy to get 
started: in short, if you are convertinq from CP/M-80 to C?/M-85, 
where will be no major changes beyond the translation to 8086 
machine code. Further, programs vou design for CP/M-86 are unward 
compatible with MP/M-36, our nultizasking operating system, as well 
as CP/NET-86 which provides a distributed overacing system in a 
network environment. 
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2. COMMAND SETUP AND EXECUTION UNDER CP/M-86 


This section discusses the overation of the Console Command 
Processor (CCP). The format of transient programs is discussed, 
along with memorv models and memory image formats. 


2.1. CCP Built-in and Transient Commands. 


The operation of the CP/M-B6 CC? is similar to that of CP/M- 
80. Upon initial cold start, the CP/M sign-on message is orintel, 
drive A is automatically loaged-in, and the standard orompt is 
issued at the console. CP/M-86 then waits for input command lines 
from the console, which mav include one of the built-in commands 


DIR ERA REN TYPE USER 


(note that SAVE is not supported under CP/M-86 since the equivalent 
function is verformed bv D0786). 


Alternatively, the command line may begin with the name of å 
-ransient program with the assumed file tyve "CMD" denoting a 
"command file.” The CMD file tyve differentiates transient command 
files used under CP/M-86 from COM files which operate under CP/M- 
80. | 


The CCP loads multiple transient orograms into memory in 
“stack order" for execution. The transient orograms themselves mav 
load additional orograms for subsequent execution. Thus, for 
example, a background orinter spooler could first he loaded, 
followed by an execution of DDT786. DDT86 mav, in turn, load a test 
orogram for a debugging session and transfer control to the test 
orogram between breakpoints. CP/M-86 keeps account of the order in 
which programs are loaded and, upon encounterina a CONTROL-C, 
discontinues execution of the most recent proaram activated at the 
CCP level. In the above case, a CONTROL-C at tne command leve? 
first discards DDTS4 and its test program, while the second 
CONTROL-C aborts the background orinter spooler. Program abort due 
to CONTROL-C does not reset the disk system (as is the case in 
CP/M-80), unless the CONTROL-C occurs at the CC? command input 
level. 


Programs loaded by the CCP or by a transient orogram are 


given storage bv C?/M-86 for their execution. The execution modeis 
are described in the followina sections. 
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2.2. Transient Program Execution Models. 


The initial values of the segment reqisters are determined by 
one of three "memory models" used by the transient orogram, and 
described in the CMD file header. The three memorv models are 


WP Wa unde ume e ee pd A dum ca e cum aum din A UP AREA umm adn aud Ram amm ee d md TD me c mh A ame aM. dh ae e HD ee cmo pum cum WEG UNE UA Gu m Ra GEN APR cmm amd cn 


| 8080 Model | Code and Data Groups Overlap | 


a p —— p EE Ha ewan wa ae cum mui GE wEP um Se 


The 8080 Model supports programs which are "itbectliw 
translated from CP/M-80 when code and data areas are intermixed. 
The 8080 Model consists only of a code grouo which, in turn, is 
normally a single segment of 64K bytes or less. The CS register 
can, however, be managed by the avolication worodram during 
execution so that multiple segments within the code grout can be 
addressed. 


The Small Model is similar to that defined bv Intel, where 
che program consists of a code group and a data group. The Small 
Model is suitable for use by oroqrams taken from CP/M-30 where code 
and data is easily separated. Note again that the code and data 
groups often consist cf, but are not restricted to, single 54K bvte 
segments. 


The Compact Model occurs when any of the extra, stack, or 
auxiliary groups are present in program. Each group may consist of 
one or more segments, but if any group exceeds one segment in size, 
or if auxiliary groups are present, then the application orogram 
must manage its own segment registers during execution in order to 
address all code and data areas. 


The three models differ orimarily in the manner in which 
segment registers are initialized upon transient proaram loading. 
The operating system program load function determines the memory 
model used bv a transient program by examining the program group 
usage, as described below. 
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2.3. The 8080 Memory Model. 


The 8080 Model is assumed when the transient program contains 
only a code group. In this case, the CS, DS, and ES reqisters are 
initialized to the beginning of the code group, while tne SS and SP 
registers remain set to a 96-byte stack area in the CCP. Thé 
Instruction Pointer Register (IP) is set to l00H, similar to CP/M- 
80, thus allowing base page values at the beginning of the data 
segment. Following program load, tne 8080 Model appears 2s 
follows, where low addresses are shown at tne too of the diagram: 


SS: | 
| CCP | 
| | 
| Stack | 

SS + SP: 
CS DS ES: -------------- 
DS+0000H: . base | 
| cage | 
cS«01208: | IP = 01008 | 
| code | 
| data | 
| code | 
: data | 


where the intermixed code and data regions are indistinguishable. 
The "base page" values, described below, are identical to CP/M-30, 
allowing simole translation from 8080, 8085, or Z80 code into tne 
8086 and 8088 environment. 
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2.4. The Small Memorv Model. 


The Small Model is assumed when the transient orogram uses 
both a code and data group. (In ASM86, all code is generated 
following a CSEG directive, while data is defined following a DSEG 
directive.) In this case, CS is set to the beginning of the code 
group, the DS and ES are set to the start of the data group, and 
the SS and SP registers remain in the CCP'/s area as shown 
graphically below: 


SS: | | 
| CCP | 
| | 
| Stack | 

SS + SP: 

CS: | IP = 000086 | 
| code ! 
| : 

DS ES: | base | 
| paqe | 
DS«0100nH: | | 
data | 
| 


where the machine code begins at CS+0000H, the "base page" values 
begin at DS«0000H, and the data area starts at DS+0100H. 
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2.5. The Compact Memory Model. 


The Compact Mode! is assumed when code and data grouos are 
oresent, along with one or more of the remaining stack, extra, orc 
auxiliary groups. In this case, the CS, DS, and ES cecisters are 
set to tne Dase addresses of their respective areas. 


It should be noted that the SS and SP recisters remain in the 
CCP area, even if a stack grou» is defined. Although it mav acpear 
that the SS and SP registers should be set to address the stack 
group, there are two contradictions. First, the transient brogram 
may be using the stack group as a data area, in which case the Par 
Call could overwrite data. Second, the SS register would logically 
be set to the base of the group, while the SP would be set to the 
Offset of the end of the group. However, if the stack groud 
exceeds 64K the address range from the base to the end of the group 
exceeds a l6-bit offset value. Therefore, if the transient oroaram 
intends to use the stack group as a stack area, the SS and SP 
registers must be set uoon entry. 


The initial configuration of the segment registers in this 
model is shown below: 


SS: ! 
| CCP | 

i 
| 
| Stack | 

SS + SP: 

CS: | I? = 0000R | 

CS: | 
| code | 
DS: | base | 
cage | 
DS+0100H: |! | 
| data | 
ES: | | 
| data | 
| 


s 


“ne values of the various segment reqisters can be oroarammatically 
changed during execution 5v loacing from the initial values placed 
in base page bv the CCP, as described below, thus allowing access 
to the entire memory space. 


Uu 
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2.6. Base Page Initialization. 


Simiiar to CP/M-80, the base page contains default values and 


locations initialized by the CCP and 
The base page occupies the regions from oft 
relative to the DS register. 


used by the transient Droqram. 
set 00008 through OOFFHR 
The values shown below in the Dase 


page for CP/M-36 include those of CP/M-80, and apvear in the same 


relative positions. 


DS. + 
DS + 
DS + 
DS: + 
DS + 


DS + 


DS + 


DS + 
DS + 
25 E 
DS + 
Ls k 


DS + 


* 


DS + 


DS + 


oS + 


DS + 


where each byte is indexed bv 


0013: 
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oe d UR m m ma al E m m 
-— qm qum aum -- ch NA m m HUN AN AR m c d c 
qa — a— emo a ee eee eee eee 
au ewe dinh eee ee ee E A a 


e um ee aqp uk ee ee 2 eee se ee id 
-— me — — eee AH A c m A c — —- 
-= a — um mir chim EB HAN Am mm Ae ED am c dm A 
am mà Swe aem cmm ee me de dad AA CUN m m d >Á 
am» Amp yy oca DU D Gu em ced ERR Am Cum cum uu VER RO mc m 


| Not 


Used 


— me í— A ur a— eee a HA A O A — oe {X 


— ap aqm cA eee AR o AR SS m ames dad EN m m ‘M 


Secin User Data | 


— ae ee cX— cua HP AM c APA m d ad VA m m E HM 


0, 1, and 2, corresoonding 


ro the 
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standard Intel storage convention of low, middle, and high-order 
(most Significant) byte, and "xxx" marks unused bvtes. LC is the 
last code group location (24-b5bits), while BC is base paragranh 
address of the code groud (l6-bits). In the 8080 Model, the low 
order bytes of LC (LCO and LCl) never exceed OFFFFH and the hign 
order byte (LC2) is always zero. Tt should be noted that bvtes LDO 
and LDl appear in the same relative positions of the base page in 
both CP/M-80 and CP/M-86, thus easing the orogram translation task. 


LD and BD provide tne last cosition and varagrach nase of the 
data group. The last position is one byte less than the arous 
length. The M80 byte is equal to 1 when tne 3080 Memory Model is 
in use. LE and BE provide the length and naragraoh base of the 
optional extra group, while LS and 3S give the cotional stack group 
length and base. The bytes marked LX and BX corressond to a set of 
four optional independent groups which mav be required for programs 
which execute using the Compact Model. The initial values for 
these descriptors are derived from the header record in the memory 
image file, described in the following section. 


2.7. Transient Program Setup and Termination. 


Similar to C2/M-80, the CCP parses ud to ewo file names 
following the command and places the properly formatted FC8's at 
locations 005CH and 996CH in the base page relative to the DS 
register. Under cp/M-80, the default DMA address is initialized to 
O082H in the base page. Due to tne seqmented memory of tne 8086 
and 8088 processors, the DMA address is divided into two Darts: 
the DMA segment address and the DMA offset. ALSO, under C>/M-86, 
the default DMA base is set to the value of DS, and the default DMA 
offset is initialized to 0080H. Thus, CP/M-80 and CP/M-R6 operate 
in the same wav: both assume the default DMA address is the second 
half of the base Dage. 


The CCP transfers control to the transient orogram ehrouch an 
8086 "Far Call." In ali but case A of the Compact Model, tne 
transient program may choose to use the 96-byte CCP stack and 
optionally return directly to the CCP upon program termination by 
executing a "Far Return." Programmatic termination also occurs when 
spos function zero is executed. The operator may terminate orogram 
execution by typing a single CONTROL-C during line edited inout 
which has the same effect as orogrammatic execution of 3S8DOS 
function zero. Contrary to tne operation of cp/mM-80, no disk reset 
occurs and the CCP and 3DOS modules are not reloaded from disk upon 
program termination. 
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3. COMMAND (CMD) PILE GENERATION 


As mentioned previously, two utility oroarams are oroviced 
with CP/M-86, called GENCMD and LMCMD, which are used to oroduce 
CMD memory image files suitable fer execution under “P/M-B6, 
GENCMD accepts Intel "hex" format files as input, while LMCMD reads 
Intel L-module files resulting from the standard Intel LOCS6 Ob3ect 
Code Locator utility.  GENCMD is used to process ourout from the 
Digital Research ASM86 assembler and Intel’s OR86 utility, while 
LMCMD is used when intel comratícle developmental software is 
available for generation of programs targeted for CP/M-86 
operation. 


3.1. The Intel Hex File Pormat. 


GENCMD inout is in Intel "hex" format oroduced 5v both the 
igital Research ASM96 assembler anc the standard Intel OH86é 
seal ey orogram (see Intel document $9300539-03 entitled "MCS-85 
Software Develooment Utitities Overating Instructions for ISIS- m 
Users"). The CMD file vroduced 5v GENCMD is oreceded by a heade 
record wnich defines che memory model and memory size requirements 
for loading and executing the CMD fiie. 


An Intel "hex" file consists of the -raditional sequence of 
ASCII records in the following format: 


ot a ee pa us ce ea 


where the beginning of the record is markec bv an ASCII colon, a 
each subsequent digit position contains an ASCII hexadecimal digi 
in the range 0-9 or A-F. The fields are defined as follows: 


IT Record Length OO-FF (0-255 in decimal) 
aaaa Load Address, Relative to Current Segment 
tt Record Type: 


90 data record, loaded starting at offset 
aaaa from current base voaradraoh 
01 end of.file, cc = FF 
02 extended address, aaaa is naragraoh 
base for subsequent data records 
04 start address is aaaa (ignored, IP set 
according to memorv model in use) 
(following are cutout from ASMB6 only) 
81 same as 00, data belongs to code secment 
82 same as 00, data belonas to data segment 
33 same as 00, data belongs to stack segment 
84 same as 00, data belonas to extra segment 
35 paragraph address for absolute code seqment 
86 paracrach address for absolute data seqment 
87 oaraqraph address for absolute stack segment 
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88 paragraph address for absolute extra segment 
d Data Byte 
ce Check Sum (CO - Sum of Previous Digits) 


All characters preceding the colon for each record are ignored. 
(Additional hex file format information je included in the ASMB6 
User’s Guide, along with Intel document +9800821A entitled "MCS-86 


Absolute Obiect Pile Formats.”) 


3.2. Operation of GENCMD. 
The GENCMD utility is invoked at the CC? level by ty7ing 
GENCMD filename Darameter-list 


where the filename corresponds to the hex input file with an 
assumed (and unspecified) file tvoe of H86. GENCMD acceots 
optional parameters to soecificaliy mark the 8080 Memory Model and 
¿o describe memory recuirements of each segment group. The GENCMD 
Sarameters are listed followina the ‘filename, as shown in tne 
command line above where the varameter-list consists of a seduence 
of keywords and values sedarated oy commas or 2lanks. The keywords 
are 


8080 CODE DATA EXTRA STACK Xl X2 X3 X4 


The 8080 keyword forces a single code groub so that the 8DOS load 
function sets up the 8080 Memory Model for execution, thus allowina 
imtermixed code and data within a single segment. "he form of this 
command is 


GENCMD filename 8080 
The remaining kevwords follow the filename or the 8080 ootion and 


define specific memory requirements for each segment Ground, 
corresponding one-to-one with tne segment groups of the base vade 


defined in the previous section. In each case, the values 
corresponding to each group are enclosed in square brackets and 
separated by commas. Sach value is a hexadecimal number 


representing a paragraph address or segment length in varagraoh 
units denoted by hahh, prefixed Sv a single letter which defines 
ene meaning of each value: 


Ahhhh Load the group at absolute location HRAN 
Bhhhh The group starts at hhnh in the hex file 
Mhhhh The group requires a minimum cf hhhh * 16 bytes 
Xhhhh The group requires a maximum of hhhh * 16 bvtes 


Generally, the IMD file header values are derived directly from tne 
hex file and the sarameters shown above need not be include 
following situations, however, recuire the use of 
parameters. 
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The 8080 kevword is included whenever ASMB6 is used 
the conversion of 8980 Drog 
when code and data is 
segment, regardless of t 


in tne source orogram. 


rams to the 8086/3088 environment 
intermixed within a single 64K 
he use cf CSEG and DSEG directives 


An absolute address (A value) must be given for any 
group which must be located at an absolute Location. 
Normally, this value is not specified since CP/M-36 cannot 
generallv ensure that the required memory region is 
available, in which case the CMD file cannot be loaded, 


The B value is used when GENCMD orocesses fil 
produced by Intel's OHS96 utility, or similar dellisw 
orogram. The output from OH86 consists of a sequence of 
data records with no information to identify code, data, 
extra, Stack, or auxiliary grouns., In this case, tne 3 
value marks the beginning address of the grouo named by tne 
keyword, causing GENCMD to load data following this address 
to the named group {see the examples below. Thus, the 3 
value is normally used to mark the boundary between code and 
data segments when no segment informaticn is included in tne 
hex file. Files oroduced by ASMS6 do not require tne use oz 
the 3 value since segment information is included in tne nex 
file. 


iF oD 
in 


The minimum memory value (M value) is included onlv 
when the hex records do not oroverly define the minimum 
memory requirements for the named group. Generally, the 
code group size is determined oreciselv by the data records 
loaded into the area. That is, zhere is exactlv one 
instruction byte loaded into each location of the code group 
and thus the size of the group is defined bv the range 
between the lowest and highest data bvte addresses. The 
data group, however, may contain uninitialized storade at 
the end of the grou» and thus no data records are present 15 
the hex file which define the highest referenced data item. 
The highest address in the data group can be defined within 
the source program by including a "DB 0” as the last data 
item. Alternativelv, the M value can be included to 
allocate the additional space at the end of tne group. 
Sinilarly, the stack, extra, and auxiliarlv group sizes must 
be defined using the M value unless tne highest addresses 
within the aroups are implicitly defined 5v data records in 
the hex file. 


The maximum memory size, given bv the X value, is 
generally used when additional free memory is recuired for 
such purposes as I/O buffers or symbol tables. IS the data 
area size is fixed, then the X parametar need not be 
included. In this case, the X value is assumed to be tne 
same as the M value. The value XFFFF allocates the largest 
memory region available but, if used, the transient orocram 
must be aware chat a three-byte length field is oroduced in 
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the base sage for this grouo where the high order byte nav 
be non-zero. Proarams converted directlv from C?/M-80 
should restrict this value to XFT7, oroducing & maximum 
allocation Length of OFFFOR bytes. 


The following is a valid GENCMD command line 
qencmd x code:a40! data'm30,wftr 
which transforms tne file X.886 into the file X.CMD with the prober 
S 


i 
header record. In this case, the code group is forced to paragraoh 
address 408, or equivalentlv, byte address i008. The data ground 


requires a minimum of 300H bytes, but can use Jo to OFPFOR bytes, 
if available. Assuming a file Y.H86 exists on drive 3 containing 
Intel hex records with no intersoersed segment information, tne 


gencmd b:y data[t30,m20] extra[550! stack[m40] x1iím40! 


oroduces the file Y.CMD on drive B bv selecting records beginning 
at address 0000H for the code segment, with records starting at 
300H allocated to the data segment. The extra segment is filled 
from records beginning at 5008, while the stack and auxiliary 
segment $1 are uninitialized areas requiring 4 minimum of 4009 
bytes each. in chis example, the data area requires a minimum of 
200H bvtes. Note again, tnat +he B value need not oe included if 
the Digital Research ASM86 assembler is used. 


3.3. Operation of LMCMD. 

The LMCMD utility operates in exactly the same manner 45 
CENCMD, with the exception that LMCMD accepts an Intel L-mocule 
file as input. The primary advantage of the L-module format is 
that the file contains internally coded information which defines 
values which would otherwise be required as varameters to GENCMD, 
such as an absolute address of an non-relocatable segment. 
Currently, however, tne only language processors which use this 
format are the standard Intel development packages, althouah 
various independent vendors will, most lixely, take advantage ot 
this format in the future. 


1 


3.4. Command (CMD) Pile Format. 


"he CMD file produced by GENCMD and LMCMD consists of tne 
128-byte header record followed immediately by the memory image. 
"nder normal circumstances, tne format of the header record is of 
no consequence to a programmer, For completeness, nowever, che 
various fields of this record are shown below. 
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|l«2-2-------- 128 Bytes ---------- > | 


lapso'Gpaliap#2! . . . 'Gpén'!/////| 


| CMD | 
Memory | 
| Image, | 
| Code, 
Data, | 
| Extra, | 
| Stack, | 
| AUX | 


an ma eee ee ee Cm ih cbe PA m lr WEN ER cem cmi wee m m ls VER VAR om o 


here GD#0 through GD&n represent “Group Descriptors." Each Croun 
Descriptor corresponds to an inderencentlv loaded region of memorv, 
and has the following fields: 


= ——— ee — — — uA A M» ub p Wo ue m m "A o m a» s E qu e s p A m im a Ap Ge um um S m m m ER m m t m m em m 


where G-Form describes the group format, or has the value zero 1£ 
no more descriptors follow. If G-Form is non-zero, then the 3-bit 
value is decomposed into two fields: 


G-Torm: 
4-bit 4-bit 


-—A E UA mcm dn EM dd di 


The G-Type field determines the Group Descriotor tvoe. The valid 
Group Descriptors have a G-Tvpe in the ranae ] through 9, as shown 
in the table below. 


| G-Tyoe | Group Tyoe | 
| 1 | Program Code Group ! 
| 2 | Independent Data Group 
| 3 | Indeoendent Extra Group | 
7 4 | Independent Stack Group i 
| 5 | Independent Auxiliary Group $1 | 
! 6 | Indeoendent Auxiliary Grouo $2 | 
| 7 Independent Auxiliarv Group 33 | 
| 3 | Independent Auxiliary Group 34 | 
| ES | Shared Code Group | 
Le S4 "nused, but Reserved : 
| 15 | Escape Code for Additional Types! 
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All remaining values in the group descriotor are given in 
increments of ló6-byte saragraoh units with an assumed low-order 9 
nibble to complete the 20-bit address. G-Length gives tne number 
of paragrachs in tne group. Given a G-length of OO05CZ, esr 
example, the size Of the group is ig 00800H = 2048D bytes. A-Base 
defines the base paragraph address for a non-relocatable group 
while G-Min and G-Max define tne minimum and maximum size of the 
memory area to allocate to the group. 6G-“"yvue 9 marks a "oure" code 
group for use under MP/M-86 and future gersions of CP/M-85. 
Presently a Shared Code Group is treated as a non-shared Program 
Code Group under CP/M-86. 


The memory model described sy a header record is implicit-"v 
determined by the Group Descriotors. The 8080 Memory Model is 
assumed when only a code group is oresent, Since no independent 
data group is named. Tne Small Model is implied when both a code 
and data group is present, but no additional group descriotorcs 
occur. Otherwise, the Compact Model is assumed when the CMD file 
is loaded. | 
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4. BASIC DISK OPERATING SYSTEM FUNCTIONS 


This Section presents the interface conventions which allow 
transient orogram access to CP/M-86 BDOS and BIOS functions. The 
3DOS calls corrspond closely to CP/M-80 Version 2 in order tO 
simplify translation of existing CP 'M-80 programs for overation 
ander CP/M-B6. BDOS entry and exit conditions are described first, 
followed bv a presentation of the individual 3DOS sunetion: Cass 


4.1. BDOS Parameters and Function Codes. 


Entry to the 2005 is accomplished through tae 8086 software 
interrupt 3224, which is reserved by Intel Corporation for use DV 
CP/M-86 and MP/M-86. The function code is passed in reaister CL 
with byte parameters in DL and word parameters in DX. Single bvte 
values are returned in AL, word values in both AX and BX, and 
double word values in ES and BX. All segment registers, excect =5, 
are saved upon entry and restored upon exit from “he 3DOS 
(corresponding to PL/M-36 conventions). The following table 
summarizes inout and output parameter passing: 


| 

| CX Function Code | ! AL Byte Value 

| DL Byte Parameter | | AX Word Value 

| DX Word Parameter | | BX  " " 

| | ! BX Double Word Offset 
| | | ES Segment Address 


DS Data Segment 


Note that the CP/M-89 3DOS requires an "information address" as 
input to various functicns. This address usually orovides buffer 
or File Control Block information used in the svstem cali. In 
CP/M-86, however, the information address is derived from “the 
current DS register along with the offset given in the DX register. 
That is, the DX register in CP/M-86 verforms the same function as 
the DE pair in CP/M-80, with tne assumotion that DS is oroperly 
set. This voses no particular problem for programs which use onlv 
a single data segment {as is the case for orograms converted from 
C?/M-80), but when the data group exceeds a single sezment, vou 
must ensure that the DS register is set to tne segment containing 
the data area related to the call. It should aiso >e noted trat 
zero values are returned for function calls which are out-of-rance. 
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ADCS Parameters and Function Codes Section 4.i. 


A list of Cp/M-86 calls is given below, with an asterisk 
following functions which differ from or are added to the set of 
CP/M-80 Version 2 functions. 


0* Svstem Reset 24 Return Login Vector 

1 Console Inout 25 Return Current Disk 

2 Console Outout 26 Set DMA Address 

3 Reader Inout 27* Get Addr (Alloc) 

4 Punch Outout 2 Write Protect Disk 

5- List Outout 29 Get AóGdr (3/0 Vector) 

6 Direct Console 2/0 30 Set File Attributes 

7 Get I/O Byte 31* Get Addr (Disk ?arms) 

8 Set I/O Byte 32  Set/Get User Code 

9 Print String 33 Read Random 

l Read Console Buffer 34 Write Random 

11 Get Console Status 35 Compute File Size 
12 Return Version Number 36 Set Random Recore 

13 Reset Disk System 37 Reset drive 
14 Select Disk 40 Write Random with Zero Fill 
15 Oven File 50* Direct BIOS Call 

16 Close File S1* Set DMA Segment Pase 

17 Search for First 52* Get DMA Seament Base 

18 Search for Next 53* Get Max Memory Available 
19 Delete Pile 54* Get Max Mem at Abs Location 
29 Read Sequential 55* Get Memory Region 

1 Write Sequential 56* Get Absolute Memory Recion 
22 Make File 57* Free memory redion 

23 Rename File 58* Free all memory 


59* Program load 
The individual 3D0S functions are described below in three 


sections which cover the simple functions, file operations, and 
extended operations for memory management and orogram loading. 


4.2. Simple BDOS Calls. 
The first set of BDOS functions cover the range O through 


12, and perform simple functions such a svstem reset, and sinale 
character 1/0. 
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dece dece dee che decode ode ode ode eoe oie dn oe ode cce ie dr desde sr ode ode oe ode ode oin dr roe Hn dn dn 


* * 
* FUNCTION 0: SYSTEM RESET id 
te * 


roe cde deese ode ode odo on cot Ce eoe Ede oe AA oe e eden e one noe dn 


* Entry Parameters: i : 
* Register Le ‘OOF la 
* Register OL: Abort code * 


dr eoe ode dede de ode AA ARA RAE AREA of ode eoe ode on RA A oe ode oon dn on on AY 


"ae 5TSLEmTM TeSet function returns control to Ehe CM 
operating system at the CCP command level. The The abort code in 
DL has two 2ossibie values: if DL = 00H then the currentlv active 
orogram is terminated and control is returned to the CCP. If DL is 
a 013, the program remains in memory and the memory allocation 


state remains unchanged. 


AEREA AD AA RADA AA REA AAA AD AAA AAA ADA AAA 


* * 
* FUNCTION 1: CONSOLE INPUT * 
* * 


doeet ode AE AAA ADA AA iode deor AAA DAD eo AAA HH 
*  ZntrVv Parameters: la 
Register CL: “BULA 


Register AL: ASCII Character 


* * 
* * 
* Returned Value: : 
* de 
de eoe ode oie sie cde ode ot fe AAA AD AAA AA AAA AD AAA de ovn d de df x6 LA AA E 

The console input function reads the next character from the 
logical console device (CONSOLE) to register AL. Graohic 
characters, along with carriage return, line feed, and dSacksvace 
(CONTROL-H) are echoed to the console. Tab characters (CONTROL-I) 
are expanded in columns of eight characters. The BDOS does not 
return to the calling Program until a character has been tvoed, 
thus susbending execution if a character is not ready. 


de ee cde fe eoe eoe ede ode eoe oe ode ode ode DAA ie ide ode ode oe de dede dee fede deiode det dn vx 


* * 
* FUNCTION 2:  CONSCLZ OUTPUT T 
* * 


AAA oe de de ode deiode ose ode ode ode ode ode ode cie oe AA AAA AAA RADA o door nt t x 


* Entry Parameters: * 
* Redister CL: 02H * 
t Register DL: ASCII Character * 
* * 


*b irse de se eode de decode ode eode e de deiode e ode oe ose de eie dte oe oe dese dno vr ino on n tk 


“he ASCII character from DL is sent to the logical consoie. 
Tab characters expand in columns of eight characters. In addition, 
a check is made for start/stop scroil (CONTRCL-S). 


-—. 


All Information Presented Here is Proprietary to Digital Research 


p 


id 
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Fe 
Ww 


Us 


zS calls 


MAR ode ode eode ode oe e e e dee de desde doe e eh e e e e on ET 


* * 
+ FUNCTION 3: READER INPUT * 
* * 
de de te de de odere dede eode ode ooi ot de dee cie de ode ode dede ove oe ede eoe de eode de dn dn n 
* Entry Parameters: 


Register CL: 03H 


$4 * 
t * 
* Returned Value: * 
* Register AL: AGCIT Character * 
dr dede de de oet ode cde deinde ode dee ode eode ode ode cde ode oe e eon dn de e de oe o o yn xx 
"He Reader Input function reads the next character from «ne 
logical reader (READER) into register AL. Control does not return 
until the character has been read. 


de ede ode ode Ee dee oe de dede de ede oe oe eH n de x 


* * 
* FUNCTION 4: PUNCH OUTPUT * 
* * 
d dede deo e de ede de oe cie eoe de ode de ode de oe dee e dede de de de de de e dn dee n 
* Entry Parameters: - 
* Register CL: 04H * 
* Register DL: ASCII Character * 
* * 


reor oe e e ede ede ode dede dede dede de de ode ode eie e de on m 


The Punch Outout function sends the character from register 
DL to the logical punch device (PUNCH). 


de ecd ode de de de eie dede oe e de oe e de AA eode dee de o o n d € 


* x 
* FUNCTION 5: LIST OUTPUT * 
* * 


de de dede e ede de de dede dede dede de eode oe de eode ede ee de ee de ee de eel 


* Entry Parameters: il 
* Register CL: 05H * 
* Register DL: ASCII Character * 
* * 


HEMET RRR eoe de e de ed dc de ede dee eoe de de de de de AA 


The List Outout function sends tne ASCII character in 
register DL to the logical list device (LIST). 
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Simple 8DOS Calls Section 4.2. 


ENANA Md tote ode dede ofr cir oie ode dic ode oe ode ode o oe dee A de ode eom croire ode oor t X 


+ * 
* FUNCTION 6: DIRECT CONSCLE I/O * 
* * 
de de de de de de RRA e eoe de e eode de ode ot deor oor eode de oe dr e e e tox ntn NR 
* Entry Parameters: ii 
= Register CL: 06H » 
* Register DL: FTH LADUE] or * 
x OFER (status) or * 
* crac. toutout) pi 
* * 
* Returned Value: * 
* Register AL: char or status x 
* ‘no value) . 
desde cde cde eoe e dede eoe de oe ode ode ode de de ode of or oe om eoe oreet de dr RAKE 


Direct console I/O is sunvorted under CP/M for those 
specialized applications where unadorned console input and output 
is required. Use of this function should, in aeneral, be avoided 
since it bvpasses all of CP/M's normal control character functions 
(e.d., CONTROL-S and CONTROL-P). Programs which oerftorm direct I/O 
through the BIOS under orevious releases of CP/M, however, should 
be changed to use direct I/O under the 300S so that they can be 
fully supported under future releases of MP/M and CP/M. 


Upon entry to function 6, register DL either contains (1! a 
hexadecimal FF, denoting a CONSOLE inout request, or (2) a 
hexadecimal FE, denoting a CONSOLE status request, or (3) an ASCII 
character to be output to CONSOLE where CONSOLE is the logical 
console device. If the input value is FF, then function 5 returns 
AL = 00 if no character is ready. Otherwise, AL contains the next 
conscle input character. If the inout value is FE, then function 6 
returns AL = 00 if no character is ready and AL = FF otherwise. If 
the input value in DL is not FE or FF, then function 6 assumes that 
DL contains a valid ASCII character which is sent to the console. 


*de eoe e ce cie oe nhe oe de of ode e eoe dette dede oe ode ode de de A eode iode e o o o Àn 


* + 
* FUNCTION 7$. GET 1/0. 87ES i 
* * 


Pe ede de de ciere ode de defe oe she ode je ode ode cde dedo oe oen ode on o o n gn d X 91 1g A fe ode de k 


* Entry Parameters: $ 
Register CL: 07H 


Register AL: I/9 Byte Value 


* * 
* * 
* Returned Value: * 
* * 
de odeode ode de de deese oir eode ie e e cire fede deo e eoe oce oe oe nde A MAA AR nod od n 


The Get I/O Byte function returns the current value of 
IOBYTE in register AL. The IOBYTE contains the current assignments 
for the logical devices CONSOLE, READER, PUNCH, and LIST srovided 
the IOBYTE facility is implemented in the 3105. 


ft ede ode eoe AE deiode eode de oe de de AEREA oe e leon dede Ke KRKEKREKaE KR ee 
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* * 
* FUNCTION 8: SET I/O BYTE * 
* - 
de ede dede ode deed oo oe de ode de dee de deo e e de e de e de e e m se 
* Entry Parameters: g 
" Register CL: 088 a 
* Register DL: I/O Byte Value ^ 
te * 


AAARARREARRERERA RARA RARA AAA RANA ANA 

The Set 1/0 3vte function changes the system IOBYTE value to 
that given in redister OL. This function allows transient orogríán 
access to the IOBYTE in order to modify tne current assignments lor 
the logical devices CONSOLI, READER, PUNCH, and LIST. 


dede de eode ode ode oe de dede e e dede d e e e e c d e e e de de e ede e de v 


* * 
* FUNCTION 9: PRINT STRING * 
* * 
decode deodede dee eode dede de de d eo de d ee e de d de e de ee o e eet 
* Entry Parameters: " 
* Register CL: 09H * 
* Register DX: String Address * 
* * 


oho dro oi ee eode de dede e de ede eode de dde e de e de d 


The Print String function sends tne character strina Stored 
in memory at the location given bv DX to the logical console device 
(CONSOLE), until a "S" is encountered in the string. Tabs are 
expanded as in function 2, and checks are made for start/stoo 


scroll and printer echo. 
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Simple BDOS Calls Section 4.2. 


dr de de de de eode ode dede de deir RA e node de oe e e e e e e de de e de e e 


* * 
* FUNCTION 10: READ CONSOLE BUFFER a 
© * 


CRAMER dec de e it de deo ode oe e e n n 


* Entry Parameters: d 


i Register CL: CAR : 
* Register DX: Buffer Address = 
* Ed 
* Returned Value: * 
* Console Characters in Buffer * 
CERRAR ARA ooo o dede de e e eoe d deo e e e e e e o m 


The Read Buffer function reads a line of edited console 
inout into a Suffer addressed by register DX from the logical 
console device (CONSOLE). Console input is terminated when either 
the input buffer is filled or when a return (CONTROL-M) or a line 
feed (CONTROL-J) character is entered. The input buffer addressec 
by DX takes the form: 


DX: +0 +1 +2 +3 +4 +5 +6 +7 +8 Ev Ou +n 


where "mx^ is the maximum number of characters which the buffer 
will hold, and "nc" is the number of characters olaced in the 
buffer. The characters entered by the operator follow the "nc" 
value. The value "mx" must be set orior to making a function 10 
call and may range in value from 1 to 255. Setting mx to zero is 
equivalent to setting mx to one. The value "nc" is returned to tae 
user and mav range from 0 to mx. If nc « mx, then uninitialized 
positions follow the last character, denoted bv "??" in tne above 


figure. Note that a terminating return or line feed character is 
not placed in the buffer and not included in the count "nc". 


A number of editing control functions are supported during 
console input under function 10. 


rub/del removes and echoes the last character 
CONTROL-C  reboots when at the beginning of line 
CONTROL~E causes ohysical end of line 

CONTROL-H  backspaces one character position 
CONTROL-J (line feed) terminates input line 
CONTROL-M freturn) terminates input line 
CONTROL-R retvpes the current line after new line 
CONTROL-U removes current line after new line 
CONTROL-X  backspaces to beginning of current line 


Certain functions which return the carriage to the leftmost 
oosition (e.g., control-X) do so only to the column position where 
the prompt ended (in earlier releases, the carriage returned to the 
extreme left margin). This convention maxes operator data input 
and line correction more legible. 


"y 
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Simple 3205 Call.s 


4dtodeode de deje ov node ode eode ode e dc dre ode RANA AA 


* * 
* FUNCTION 11: GET CONSOLE STATUS * 
* * 


eee ee eode eoe e sie oe dede de ode ode cin e ee el 


* Entry Parameters: * 
* Bec:ster CL: 23H * 
* * 
* Returned Value: s 
T Recister AL: Consoie Status * 
tore eode ck ode decedere ee ee ee ee ee ee ee n de o m 


racter has 
character 
tnerwise a 


(t 


The Console Status function checks to see if a ch 
been typed at the logical console device ( ONSOLE) E 
is ready, the value 01H is returned in register 

00H value is returned. 


v oO 
O y fu 


PRUETT ode oe i oe de ode eoe AAA 


* * 
* FUNCTION 12: RETURN VERSION NUMBER * 
* * 
defe ode dr je de ode de de de de toe dede Hn HET KKK Kee 
* Entry Parameters: id 
sl register Li OCH a 
* * 
* Returned Value: T 
* Register BX: Version Number * 
de ode dede eode dede ode dede ode ode ode dee de dede ie ie eoe de dp nci Pe de n de det o o 


Function 12 provides information which allows version 
independent programming. A two-Dvte value is returned, with BH = 
00 designating the CP/M release (3H = 01 for MP/M), and BL = 00 for 
all releases orevious to 2.0. CP/M 2.0 returns a hexadecimal 20 in 
register BL, with sudsequent version 2 releases in the hexadecimal 
range 21, 22, through 2P. In order to orovide version number 
compatibilitv, the initial release of CP/M-86 starts with 2.2. 


4.3. BDOS File Operations. 


Tunctions 12 throuah 52 are related to disk file overations 
under CP/M-86. In manv of these operations, DX provides the DS- 
relative offset to a file control block (FCB). The Pile Controi 
Block (FCB) data area consists of a sequence of 33 bytes tor 
sequential access, or a sequence of 36 bytes in the case that the 
file is accessed randomlv. The default file control block normally 
located at offset 005CH from the DS register can be used for for 
random access files, since bytes 007DR, 0078H, and 007FH are 
available for this nurcose. The FCB format is shown below with the 
follewing fields: 
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3D0S File Operations Section 4.3. 


—— am b ue cm cm dm UP QD AR UR WE GS b A m m n GU A VER E A Ga ue m A A A A AA m ot m m e n n 


00 01 02 ... 08 09 10 11 12 13 14 15 16 ... 31 32 33-34 3° 


wnere 
dr drive code (9 - 16) 

O => use default drive for file 

] => auto disk select drive A, 

2 => auto disk select drive 3, 


l6s» auto disk select drive FP. 


Elo Ea contain the file name in ASCII 
upper case, with high bit = 0 


tl,t2,t3 contain the file type in ASCII 
upper case, with high bit = 0 
tl^, t2^, and t3^ denote the 
bit of these positions, 
tl’ = ] s» Read/Only file, 
t2^ = 1 => SYS file, no DIR list 


ex contains the current extent number, 
normally set to 00 by the user, but 
in range 0 - 31 during file I/O 


sl reserved for internal system use 


s2 reserved for internal system use, set 
to zero on call to OPEN, MAKE, SEARCH 


rc record count for extent "ex," 
takes on values from 0 - 128 


dO...dn filled-in by CP/M, reserved for 
System use 


er current record to read or write in 
a sequential file overation, normally 
set to zero by user 


rO,ri,r2 optional random record number in che 
range 0-65535, with overflow to rz, 
r0,cl constitute a 16-bit value with 
low byte r0, and high byte rl 


For users of earlier versions of CP/M, it should be noted in 
passing that both CP/M-80 Version 2 and CP/M-86 perform directortv 
operations in a reserved area of memory which loes not affect write 
buffer content, exceot in the case of Search and Search Next where 
the directory record is covied to the current CMA address. 
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BDOS Pile Operations Section 4.5. 


There are three error situations which the BDOS may 
encounter during file processing, initiated as a result of a BDOS 
Pile I/O function call. When one cf these conditions is detected, 
the BDOS issues the following message to the console: 


DOS ERR ON x: error 


where x is the drive name of the drive selected when tne error 
condition is detected, and "error" is one of the three messages: 


BAD SECTOR SELECT BrO 
mhese error situations are trapped by the BDOS, and *hus the 
executing transient program is is temporarily haited when tne error 
to 


is detected. No indication of the error Situation is returned 
the transient orogram. 


The "SAD SECTOR" error is issued as the result of an error 
condition returned to the BDOS from the BIOS module. The BDOS 
makes BIOS sector read and write commands as vart of the execution 
of BDOS file related system calls. If the RIOS read or write 
routine detects a hardware error, 1t returns an error code to the 
BDOS resulting in this error message. The operator may resconá to 
this error in two wavs: a CONTROL-C terminates the executing 
orogram, while a RETURN instructs CD/M-=86 to ignore the error and 
allow the program to continue execution. 


The "SELECT" error is also issued as the result of an error 
condition returned to the BDOS from the BIOS module. The 3DOS 
makes a BIOS disk select call prior to issuing any BIOS read or 
write to a oarticular drive. If the selected drive is not 
supported in the BIOS module, it returns an error code to the BDOS 
resulting in this error message. C?/M-86 terminates the currently 
running program and returns to the command level of the CCP 
following any input from the console. 


The "R/O" message occurs when the 3DOS receives a command to 
write to a drive that is in read-only status. Drives may be placed 
in read-only status explicitly as the result of a STAT command or 
BDOS function call, or implicitly if the BDOS detects that disk 
media has been changed without performing a "warm searr," "he 
ability to detect changed media is optionally included in the BIOS, 
and exists only if a checksum vector is included for the selected 
drive. Upon entry of any character at the kevboard, the transient 
orogram is aborted, and control returns to the CCP. 
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dr eost ode ode de cde ode cieocde dee eoe dn ire eoe fe onde oe oder ode eode oe eo on f n n 9X 


* * 
* FUNCTION 13: RESET DISK SYSTEM x 
* * 


Pe defe de de se de de de decode dece ode de ede cde ede eoe oe e ode de cie ANA on dn n don f 


* Entry Parameters: A 
* Register CL: ODE d 
* dr 


AEREA ode ode eoe dede ode de ode eode AAA A ode dee eoe A ARA on Gg d d 


The Reset Disk Function is used to orogrammatically restore 
the file system to a reset state where all disks are set to 
read/write (see functions 28 and 29), only disk drive A is 
selected. This function can be used, for examole, bv an 
application program which requires disk changes during operation. 
Function 37 (Reset Drive) can also be used for this purpose. 


deme dee e e ein ie he de dee dr de e dr de ede ode A e de eche dee e e e 9 n vf 


* * 
* FUNCTION 14: SELECT DISK s 
* * 
de e dede dede ce eee oe dede de ie dne AA KKK RAE de de de n o n n 
* Entry Parameters: T 
* Register CL: OH » 
* Register DL: Selected Disk x 
* * 


de 3t e cir ede de de ide de de e ode de dr dee ode eode ode eode eoe dede den dede oe n de n d àx 


The Select Disk function designates the disk drive named in 
register DL as the default disk for subsequent file operations, 
with DL = 0 for drive A, 1 for drive B, and so-forth through 15 
corresponding to drive P in a full sixteen drive system. Is 
addition, the designated drive is loaged-in if it is currentlv in 
the reset state. Logging-in a drive olaces it in "on-line" status 
which activates the drive’s directory until the next cold start, 
warm start, disk svstem reset, or drive reset operation. PCB's 
which specify drive code zero (dr = OOR) automaticallv reference 
the currently selected default drive. Drive code values between 1 
and 16, however, ignore the selected default drive and directly 
reference drives A through P. 
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dee de deo e de oA de do o dede dede Rd e FR e o 


* * 
* FUNCTION 15: OPEN FILE = 
* ar 


ee dede ded dede de de de e de dede de de de e e ee e de eo d eo 


* Entry Parameters: T 
Register CL: OFH 
Register DX: FCB Address 


Register AL: Directory Code 


* 
* 
t 
+ 
t 
RUTHER deo eode de de ede dr de e ee e dee de e oi ow 


* 

* 

* 

Returned Value: of 
xr 

* 


The Oven File operation is used to activate a FCS soecifyina 
a file which currently exists in the disk directory for tne 
currently active user number. The BDOS scans the disk directory of 
the drive specified by byte 0 of the FCB referenced by DX for a 
match in positions 1 through 12 of the referenced FCB, where an 
ASCII question mark (3FX) matches any directory character in any of 
these positions. Normally, no question marks are included and, 
further, byte "ex" cf the FCS is set to zero before making the open 
call. 


If. a direret element is matched, the reievant directory 
information is covied into bytes 30 through dn of the PCB, thus 
allowing access to the files through subsequent read and write 
overations. Note that an existing file must not be accessed until 
a successful open overation is completed. Further, an FCB not 
activated by either an open or make function must not be used in 
BDOS read or write commands. Upon return, the open function 
returns a "directory code" with the value 0 through 3 if the open 
was successful, or OFFH (255 decimal) if the file cannot be found. 
If question marks occur in the FCB then the first matching FCB is 
activated. Note that the current record ("cr") must be zeroed by 
the orogram if the file is to be accessed sequentiallv from the 
first record. 


All Information Presented Here 15 eroorietarv to Diaital Research 


30 


3DOS File Operations section 4.3, 


rode ee de eode dede ode rode RARA dede ode dee e e de de lr e de do dert wy 


* * 
* FUNCTION 15: CLOSE FILE A 
* * 


Tt e cde fe she de e se e dr ie de deiode oe ost dee n eoe de de ode ode oe d n e d d dern er 


* Entry Parameters: x 
Register CL: 108 
Register DX:  FCB Address 


Register AL: Directory Code 


* 
* 
* 
* 
* 
Je dede de e noe e oie sie oie eoe oe e dedere den oe de om oon B e e dr der o dn n dn 


= 
* 
* 
Returned Value: * 
* 
* 


The Close Pile function verforms the inverse of the oven 
tile function, Given that the FCB addressed by DX has been 
previously activated through an oven or make function (see 
functions 15 and 22), the close function permanently records the 
new FCB in the referenced disk directory. The FCB matching process 
for the close is identical to the open function. The directory 
code returned for a successful close operation is 0, 1l, 2, or 3, 
while a OFFH (255 decimal) is returned if the file name cannot be 
found in the directory. A file need not be closed if only read 
Operations have taken place. If write operations have occurred, 
however, tne close operation is necessary to vermanently record the 
new directory information. 
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dr fe fe cie de eoe eode ode cie toe ode dee fe ode oe ode de ode iron AA ERA RADA AAA 


* * 
* FUNCTION 17: SEARCH FOR FIRST 
* * 
dr Jede de dede oe oe de oir oe ode de oe eode ode ode ode ode ode e eo AAA ADS n dn oro ode eodem tn 
* Entry Parameters: * 


Register CL: lH 
CB Address 


Reqister DX: 


raj FP! 


Register AL: Directory Code 


* 
ar 
* 
* 
* 
de de he e he e ede e de ode oe cie cde e ide oie eode e oie eoe ode ire nhe od deese de nod on t f$ 


* 
* 
* 
* Returned Value: 
* 
* 


Search First scans the directory for a match with the fiie 
given by the FCB addressed bv DX. The value 255 (hexadecimal FF) 
is returned if the file is not found, otherwise 0, 1, 2, or 3 is 
returned indicating the file is oresent. In the case that the file 
is found, the current DMA address is filled with the record 
containing the directorv entry, and the relative starting position 
is A * 32 li.e., rotate the A register left 5 bits, or ADD A five 
times). Although not normally required for aoplication orograms, 
the directory information can be extracted from the buffer at this 
dosition. 


An ASCII question mark (53 decimal, 3F hexadecimal) in anv 
position from "fl" through "ex" matches the corresvonding field of 
any directory entry on the default or auto-selected disk drive. If 
the "dr" field contains an ASCII question mark, then the auto disk 
select function is disabied, the default disk is searched, with the 
search function returning any matched entry, allocated or free, 
belonging to any user number. This latter function is not normallv 
used by application programs, but does allow complete flexibility 
to scan all current directory values. If the "dr" fiela is not a 
question mark, the ^s2" byte is automatically zeroed. 


KERR de cde de cde cde dede ode ife RASTER ERR ARR deo e n e gn n t 


* * 
* FUNCTION 18: SEARCH FOR NEXT » 
* * 


de eoe de de e cie ode oe ED ADA ADA ADA ode oe ode oe e dede de cic ode e de eode eee e 


* Entry Parameters: * 
Register CL: 12H 


* * 
* t 
* Returned Value: * 
* Reaister AL: Directory Code * 
Je cit de dede ode ode ode deo n ode de ode ode de ode ode dece ode cfe oe ode AAA AA deiode che e oe ode de ode o KH 

The Search Next function is similar to the Search First 
function, except that tne directory scan continues from the last 
matched entry, Similar to function 17, function 18 returns the 
decimal value 255 in A when no more directory items match. In 
terms of execution seauence, a function 18 call must follow airther 
a function 17 or function 18 call with no other intervening 3005 
disk related function calis. 
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de de e id ode ode o de eode e ode de Re Re de eode eode de deor le on m de n RR 


* i * 
* FUNCTION 19: DELETE FILE el 
* * 


de dede fet cde de de de deiode ode ode oe dele de eode eoe e ie e de de decree ee dr de on dn n 9n * 


* Entry Parameters: 5 
x Register TZL: 13H * 
T Register DX: FCS Address * 
* * 
* Returned Value: * 
Tr + 
* * 


Register AL: Return Code 
de de de deo ce oe ode cde e det oie ood de de A dt de oe oe ode ee ARA RAN e n *f 


The Delete File function removes files which match the FCB 
addressed by DX. The filename and tvpe mav contain ambiauous 
references ([(i.e., question marks in various vositions), out tne 
drive select code cannot be ambiguous, as in the Search anc Search 
Next functions. Function 19 returns a OFFH (decimal 255) if the 
referenced file or files cannot be found, otherwise a value of zero 
is returned. 


dr c e de de ede de cie de ode ode oe oe ode ode cin dee n dete eode cce dn dee e c e e x 


* * 
* FUNCTION 20: READ SEQUENTIAL * 
* t 
de Je it de fe ode toe e dede deo ode dn de dede de dede de oie ee e oe ode ede dn e de e on n Nf 
* Entry Parameters: " 
* Register CL:  i4H a 
* Register DX: FCB Address * 
* * 
* Returned Value: al 
* Register AL: Return Code * 
$t de deci Ye de e de deo Roe fe ode ode eoe ede code ede ir cde de e de dede ode o 9 o n 


Given that the FCB addressed by DX has been activated 
through an open or make function (numbers 15 and 22), the Read 
Sequential function reads the next 128 bvte record from the file 
into memorv at the current DMA address. the record is read from 
position "cr" of the extent, and the "cr" field is automatically 
incremented to the next record position. . If the "cr" field 
overflows then the next logical extent is automaticallv opened and 
ehe "cr" field is reset to zero in preparation for the next read 
operation. The "cr^ field must be set to zero following the oven 
call by the user if the intent is to read sequentially from the 
beginning of the file. The value OOH is returned in tne AL 
register if the read ooeration was successful, while a value of 01H 
is returned if no data exists at the next record oosition of the 
file. Normallv, the no data situation is encountered at the enc of 
a file. However, it can also occur if an attemot is made to read a 
data block which has not been oreviously written, or an extent 
which has not been created. These situations are usually 
restricted to files created or appended bv use of the BDOS write 
Random commmand (function 34). 
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Ul 


RRMA oe od d de ee de ie de de e dev de de con à À 


* * 
* FUNCTION 21: WRITE SEQUENTIAL " 
* * 


ERR deo oe de de ede dede ode de dede der e de e e de de de de de e d o n f 


* Entry Parameters: * 
x Register CL: 15H X 
* Register DX: FCS Address * 
* * 
* Returned Value: z 
i Register AL: Return Code * 
de dec de eoe ede ode dede dee ode e de de e de e d e de e c e e ede o t gv 


Given that the TCB addressed by DX has been activated 
through an open or make function (numbers 15 and 22), tne write 
Sequential function writes the 128 byte data record at the current 
DMA address to the file named bv the FCB. the record is slaced at 
position "cr" of the file, and the "cr" field is automaticallv 
incremented to the next record position. If the “cr” field 
overflows then the next logical extent is automatically opened and 
the "cr" field is reset to zero in oreparation for the next write 
operation. Write operations can take place into an existing file, 
in which case newly written records overlav those which already 
exist in the file. The "cr" field must be set to zero following an 
open or make call by the user if the intent is to write 
sequentially from the beginning of the file. Register AL = OOH 
upon return from a successful write overation, while a non-zero 
value indicates an unsuccessful write due to one of the following 
conditions: 


01 No available directory space - This condition occurs 
when the write command attempts to create a new extent 
that requires a new directory entry and no availabie 
directory entries exist on the selected disk drive. 


02 No available data block - This condition is encountered 
when the write command attempts to allocate a new data 


block to the file and no unallocated data blocks exist 
on the selected disk drive. 
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decre de de dede ode eoe ode ot ode ede ode oe de de de dede de de de e de re ed dee v 


E * 
* FUNCTION 22: MAKE FILE * 
* * 


de dde de de eode de de ode dede ode ode de ode ode de ode ode ode e ede oe nee en de de de de n XA 


* Entry Parameters: * 
Register L: L6H 
Register DX: FCS Address 


* * 
* * 
* * 
* Returned Value: * 
* Register AL: Directory Code * 
dete dee cde ode AAA RARA AR e ce te e ede e A A RR 


The Make File operation is similar to the oven file 
operation except that the FCB must name à file which does not exist 
in the currently referenced disk directocy (i.e., the one named 
explicitly by a non-zero "dr" code, or the default disk if "dr" is 
zero). The BDOS creates the file and initializes both tne 
directory and main memory value to an empty file. The srogrammer 
must ensure that no duplicate file names occur, and a orecedinc 
delete overation is sufficient if there is any possibility of 
duslication. Upon return, register A = 0. Li 24 grt. 33 1L me 
operation was successful and OFFH (255 decimal) 1í no more 
directory soace is available. The make function has the side- 
effect of activating the FCB and thus a subsequent open is not 
necessary. 


ee de fe dede ee dede oie ode de dede de de oe de e de de e de e e de e o e 


* * 
* FUNCTION 23: RENAME FILE a 
* * 


odd cede dede dede dede de de dede dede deo dee de ede de de de de de e e e ode 


* Entry Parameters: id 
Register CL: 17H 
Register DX: FCB Address 


Register AL: Return Code 


* 
* 
* 
* 
* 
HARE e e ede e ede de de d de eR Re de e e de e o x 


* 
* 
* 
* Returned Value: 
* 
* 


The Rename function uses the PCS addressed by DX to change 
all directory entries of the “ile specified by the file name in the 
first 16 bvtes of the FC3 to the file name in the second 15 ovtes. 
It is the user/s responsibility to insure that the file names 
specified are valid CP/M unambiguous file names. The drive code 
"dr" at position 0 is used to select the drive, while the drive 
code for the new file name at position 16 of the FCB is ignored. 
Upon return, register AL is set to a value of zero if the rename 
wag successful, and OFFH (255 decimal) if the first fila name could 
not be found in the directory scan. 
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khdmdrkok ded eo deo dede de de de de de dede oe e on 


* * 
* FUNCTION 24: RETURN LOGIN VECTOR si 
E * 


Pere TTT TT TT Ter ode e de e e d e dede e e ge e RR 


* Entry Parameters: * 
Register CL: 18H 


* * 
* * 
* Returned Value: Si 
* Register BX: Login Tecor A 
aka Ad UR AAA RARA e Re 


The login vector value returned by CP/M is a 16-bit value in 
SX, where the least significant bit corresvonds to the first drive 
A, and the high order bit corresponds to tne sixteenth drive, 
labelled P. A "^0" bit indicates that the drive is not on-line, 
while a "l" bit marks an drive that is actively on-line due to an 
explicit disk drive selection, or an implicit drive select caused 


by a file operation which specified à non-zero "dr" field. 


Bak AA RCR GRO ded RR e eek o e 


* * 
* FUNCTION 25: RETURN CURRENT DISK > 
dr * 


eee REET ode dede ede RR RR e e ed RO UR 


* Entry Parameters: " 
Register CL: 19H 


Register AL: Current Disk 


dr * 
* * 
* Returned Value: * 
Y * 
eee EER EAE R ded e ede EEE AE ES 


Function 25 returns the currently selected default disk 
number in register AL. The disk numbers cange from 0 through 15 
corresponding to drives à through P. 
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ERE RRR deo oom o de de ee de de dece de e e eo 


* * 
* FUNCTION 26: SET DMA ADDRESS x 
* * 


dock deo dee dp e d e e e e de d e e e e de e de e e eo 


* Entry Parameters: se 
T Register CL: ‘iAH * 
* Register DX: OMA Offset 2i 
* * 


rode de eode deo deno n t AX $ed de de decode de dede e e de c de de e e e e aa 


"DMA" is an acronym for Direct Memory Address, which is 
often used in connection with disk controllers which directly 
access the memory of the mainframe computer to transfer data to and 
from the diss subsystem. Although many computer svstems use non- 
DMA access (i.e., the data is transfered through programmed I/O 
operations), the DMA address has, in CP/M, come to mean the address 
at which the 128 byte data record resides before a disk write and 
after a disk read. In the CP/M-86 environment, the Set DMA 
function is used to specify tne offset of the read or write buffer 
from the current DMA Dase. Therefore, to svecify the DMA address, 
both a function 26 call and a function 51 call is required. Thus, 
the DMA address becomes the value specified bv DX plus the OMA Dase 


value until it is changed oy a subsequent Set DMA Function. 


kd dd d deo dee de de de e e eer ES 


* * 
* FUNCTION 27: GET ADDR(ALLOC) - 
* * 
bed dd kd dde d de de doe i ded dee o e o ES 
* Entry Parameters: R 
* Register Li 19H a 
* * 
* Returned Value: = 
ie Register BX: ALLOC Offset : 
* Register ES: Segment base * 
kk ede Rede de de RR e e e d o dee ede RSENS 


An "allocation vector" is maintained in main memory for each 
on-line disk drive. Various system programs use the information 
provided by t^e allocation vector to determine the amount of 
remaining storage (see the STAT program). runction 27 returns the 
segment base and the offset address of the allocation vector for 
rhe currentlv selected disk drive. The allocation information may, 
however, be invalid if the selected disk has been marked read/only. 


t7 
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dede ode droite dede de eode oe ode de de dee de e de d e e dom CEE eo t 9n deo 


* * 
* FUNCTION 28: WRITE PROTECT DISK T 
* * 


wood de dede dede ede de e ede e e e d e de dee o eon e e de d e 


* Entry Parameters: * 
* Register CL: ¿CH la 
* * 


ee de eode eode de e d o Fe de e de e e RH n n go e d 


The disk write orotect function provides temporary write 
orotection for the currently selected disk. Anv attempt to write 
ro the disk, before the next cold start, warm start, disk system 
"eset, or drive reset operation oroduces the message: 


ados Err on d: R/O 


ARRE de de dece oH e de e RO RR de e oe eoo de e 


* x * 
* FUNCTION 29: GET READ/ONLY VECTOR * 
* * 
doo ode deo dede dede ode de de de ice de ode e de Ee e ee d e e e 
* Entry Parameters: ii 
* Register CL:  1DH = 
* * 
* Returned Value: le 
* Register 3X: R/O Vector Value* 
RE e Ro ER FR Rode RO Rn de e RE o e 


Function 29 returns a bit vector in register 3X which 
indicates drives which have the temporary read/only bit set. 
Similar to function 24, the ieast significant bit corresponds to 
drive AL, while the most significant bit corresoonds to drive P. 
The R/O bit is set eithe- by an explicit call to function 28, or bv 
“he automatic software mechanisms within CP/M which detect changed 
disks. 
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de e de de de de eode e cde ode oe ode ode ode cde ote ded eode oe eoe oe eoe fede de e fe de dn d 


* * 
* FUNCTION 30: SET FILE ATTRIBUTES * 
*r * 
de eode dede he ode eode fede orn ode cin de ie eoe de oe oe cde oe de eoe fee ARAN 
* Entry Parameters: ze 


Register CL: LEH 
Register OX:  FCB Address 


Register AL: Return Code 


* 
* 
* 
* 
* 
^r de t cire ode de ode de oe ode ode ode ode rede e e ee dee ede deno e de c dn n x 


* 
* 
* 
* Returned Value: 
* 
* 


The Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files. In 
oarticular, the R/O, System and Archive attributes (Ly Ez, dnd 
t3^) can be set or reset. The DX pair addresses a FCB containing a 
file name with the appropriate attributes set or reset. It is the 
users responsibility to insure that an unambiguous file name is 
not svecified. Function 30 searches the FCB specified or default 
disk drive directory area for directory entries that belong to tne 
current user number and that match the FCB specified name and tyve 
fields. All matching directory entries are updated to contain the 
selected indicators. Indicators £1” through f4^ are not oresently 
used, but may be useful for applications orograms, since thev are 
not involved in the matching process during file oven and close 
operations. Indicators £5° through f8' are reserved for future 
system expansion. The currently assigned attributes are defined as 
follows: 


tl’: The R/O attribute indicates if set that the file is in 
read/only status.  BDOS will not allow write commands 
to be issued to files in R/O status. 

tz The Svstem attribute is referenced by the CP/M DIR 

utility. If set, DIR will not disolay the file ina 

directory disolay. 


t3^: The Archive attribute is reserved but not actually 
used by CP/M. If set it indicates that the file has 
been written to back up storage by a user written 
archive program. To implement this facility, the 
archive program sets this attribute when it covies a 
file to back up storage; any oroarams uodating or 
creating files reset this attribute. Further, the 
archive program backs up only those files that have 
the Archive attribute reset. Thus, an automatic back 
ub facility restricted to modified files can be easily 
implemented. 


Punction 30 returns with register AL set to OFFTH (255 
ue 


decimal) if the referenced file cannot be found, Otherwise a val 
of zero is returned. 
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de e de dede eoe ode ie eoe de dee oe deo n e e de dn dee e eoe deo d d d m 
* * 
* FUNCTION 31: GET ADDR(DISK PARMS) * 
se , * 
de dede ode de ode ode de de ede de eode de de ede eode oe dee oe de oe e e e e e e x 


* Entry Parameters: le 
Register CL:  LFH 


* * 
* * 
* Returned Value: h 
* Register 3X: DPB Offset A 
T Register ES: Segment Base x 
dede te de e e de dfe de oe ode de e de efe e de eoe de eee Fe e e d e e n e de n f 

The offset and the segment base of tne 3105 resident disk 
parameter block of the currently selected drive is returned in 3X 
and ES as a result of this function call. This control block can 
be used for either of two purposes, First, the disk parameter 
values can be extracted for display and space computation purposes, 
or transient programs can dynamically change the values of current 
disk parameters when the disk environment changes, if required. 
Normallv, abplication programs will not require this facility. 
Refer to Section 6.3 for the definition of the BIOS disk Darameter 
block. 


de ede cie de de dede eode cde oe de eode ee eee de cde ie e de de e eoe de de n d e e x 


* * 
* FUNCTION 32: SET/GET USER CODE * 
4 * 
de eode ode ede cde ode ode ede dee eoe ode de oe de de te de de de ie de dede de de d e n oem 
* Entry Parameters: g 
* Register CL: 20H x 
1 Register OL: OFFA (get) or i 
" User Code (set) * 
* * 
* Returned Value: * 
* Register AL: Current Code or * 
* no value * 
de ederet ede dede eode de de ode ode de de eed de eode de de dee e dee e e g 


An application program can change or interrogate tne 
currently active user number vy calling function 32. If register 
DL = OFFH, then the value of the current user number is returned in 
register AL, where the value is in the range 0 to 15. If register 
DL is not OFFH, then the current user number is changed to tne 
value of DL (modulo 16). 


All Information Presented Here is Proprietary to Digital Research 


49 


BDOS File Operations Section 4.3. 


de dede de dede ode ode dede oe eod de e de e e de ede de de e e de e de de e e ee mom e 


* * 
* FUNCTION 33: READ RANDOM * 
* * 


deed dede dr dde dede de de de de de de dede e dee e e e 


* Entry Parameters: a 
Register CL: 21H 
Register DX: FCB Address 


Register AL: Return Code 
dee ooo ode e e de e e EET RARER TRAE THES 


* * 
* * 
* * 
* Returned Value: : 
* »* 
* * 

The Read Random function is Simitar to the sequential file 
read operation of previous releases, except that the read operation 
takes olace at a particular record number, selected by the 2À4-Di* 
value constructed from the three byte field following the PCS (byte 


positions 19 at 33, ri at 34, and r2 at 19) Note that che 
sequence of 24 bits is stored with least significant byte. Tiest 
(10), middle byte next (11), and high byte last (r2). CP/M does 


not reference byte r2, excest in computing the size GE a file 
(function 35). Byte r2 must be zero, however, since a non-zero 
value indicates overflow vast the end of file. 


Thus, the r0,rl byte Dair is treated as a double-cvte, OF 
"word" value, which contains the record to read. This value ranges 
from 0 to 65535, providing access to any particular record of any 
size file. In order to access a file using the Read Random 
function, the base extent (extent 0) must first he obenec. 
Although the base extent may or may not contain any allocated data, 
this ensures that the FCB is oroverly initialized for subsequent 
random access operations. The selected record number is then 
stored into the random record field (c0,cl), and the BDOS is called 
to read the record. Upon return from the call, register AL either 
contains an error code, as listed below, or the value 00 indicating 
the operation was successful. In the latter case, the current DMA 
address contains the randomly accessed record. Note that contrarv 
to the sequential read operation, the record number 1S not 
advanced. Thus, subsequent random read operations continue t0 read 
the same record. 


Uoon each random read operation, the logical extent and 
current record values are automatically set. Thus, tne file can 5e 
sequentiallv read or written, starting from the current randomly 
accessed position. Note, nowever, that in this case, che last 
randomly read record will de re-read as you switch from random mode 
to sequential read, and the last record will be re-written as vou 
switch to a sequential write operation. You can, of course, simoly 
advance the random record position Following each random read or 


. 


write to obtain the effect of a sequential 1/0 overation. 
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Error codes returned in register AL followina a random read 
are listed below. 


Ol Reading unwritten data - This error code is returned 
when a random read cperaticn accesses a data block which 
has not been previously written. 


02 (not returned bv the Rancom Read command) 


turned when 3DOS cannot close the current extent orior 

o moving to the new extent containina the recorá 
specified ty Dvtes r0,rl of the “C3. This error can 5e 
caused by an overwritten PCB Or à read random operation 
on an FCB that has not been opened. 


03 Cannot close current extent - mhis error code is 
re 
pod 


n extent - This error code is returned 
ead operation accesses an extent that has 
d. This error situation is equivalent to 


04 Seek to unwrit 
when a random c 
not been Create 
error Ol. 


05 not returned by the Random Read commanc) 


06 Random record number out of range - This error code is 
returned whenever byte r2 of the FCS is non-zero. 


Normally, non-zero return codes can be treated as missing data, 
with zero return codes indicating operation comolete. 


de RRR ERE TEER e o RER Ext 


* 
* FUNCTION 34: WRITE RANDOM * 
* * 
okde dede de e de de de do e dede de e de de de dede He de eee 
* Entry Parameters: = 
* Register CL: 22H * 
x Register DX:  FCB Address * 
* * 
* Returned Value: " 
* Register AL: Return Code xi 
odo dde dede de o e eoe dee de e e d m dede e de e ee woo x 


The Write Random operation is initiated similar to tne Read 
Random call, except that data is written to the disk from the 
current DMA address. Further, if the disk extent or data SloCk 
which is the target cf the write has not vet oeen allocated, tne 
allocation is performed before the write operation continues. As 
im the Read Random ocoeration, rhe random record number is not 
changed as a result of ene write. The logical extent number and 
current record positions of tne file control block are set to 
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correspond to the random record which is being written. Sequential 
read or write overations can commence following a random write, 
with the note that the currently addressed record is either read or 
rewritten again as the sequential operation begins. You can also 
Simply advance the random record position following each write t 

get the effect of a sequential write operation. In particular, 
reading or writing the last record of an extent in random mode joes 
not cause an automatic extent switch as it does in sequential mode. 


In order to access a file using the Write Random function, 
tne base extent (extent 0) must first be opened. As in the Read 
Random function, this ensures that the FCB is properly initialized 
for subsequent random access operations. If the file is emotv, a 
Make File function must be issued for the base extent. Although 
the base extent may or may not contain any allocated data, this 
ensures that the file is Droperly recorded in the directory, and is 
visible in DIR requests. 


Uoon return from a Write Random call, register AL either 
contains an error code, as listed below, or the value 00 indicating 
the overation was successful. 


Ol (not returned by the Random Write command) 


02 No available data block - This condition is encountered 
when the Write Random command attemots to allocate a new 
data block to the file and no unallocated data blocks 
exist on the selected disk drive. 


03 Cannot close current extent - This error code is 
returned when BDOS cannot close the current extent prior 
to moving to the new extent containinq the record 
specified by bytes r0,rl of the FCB. This error can be 
caused bv an overwritten FCB or a write random operation 
on an FCB that has not been opened. 


04 (not returned bv the Random Write command) 

05 No available directory space - This condition occurs 
when the write command attempts to create a new extent 
that requires a new directory entry and no available 
directory entries exist on the selected disk drive. 


06 Random record number out of range - This error code is 
returned whenever byte 72 of the FCB is non-zero. 
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de de dedere eoe de ode de dede eoe ede de de ode ode eoe e dede fe e de e dn dr d ktt 


* Fr 
* FUNCTION 35: COMPUTE FILE SIZE * 
* * 
dr de de he he de de ode oe de ode oe eode de eode de eo eode de in em de de de AN i eoe 
* Entry Parameters: i 
* Register CL: 238 * 
* Register DX: FCB Address * 
* * 
* Returned Value: - 
a Random Record Field Set * 
dede ode de dede ode cie oe ode ode cie eoe ode e cie dee eode e e e ddr e e ode dee e eoe o o» 


When computing the size of a file, the DX register addresses 
an FCB in random mode format (bytes r0, rl, and r2 are oresent). 
The FCB contains an unambiguous file name which is used in the 
directory scan. Upon return, the random record bytes contain the 
"virtual file size which is, in effect, the record address of the 
record following the end of the fiie. if, following a call to 
function 35, the high record byte r2 is Ol, then the file contains 
the maximum record count 65536. Otherwise, bytes r0 and rl 
constitute a l6-Dit value (r0 is the least significant byte, as 
before) which is the file size. 


Data can be appended to the end of an existing file by 
simply calling function 35 to set the random record position to the 
end of file, then performing a sequence of random writes startinq 
at the preset record address. 


The virtual size of a file corresponds to the ohysical size 
when the file is written sequentially. If, instead, the file was 
created in random mode and "holes" exist in the allocation, then 
the file may in fact contain fewer records than the size indicates. 
If, for examole, a single record with record number 65535 (CP/M's 
maximum record number) is written to a file using the Write Random 
function, then the virtual size of the file is 65536 records, 
although only one block of data is actually allocated. 
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dede de dt de de oe deo de oe de cde ode d ot eode mde e d oh d de AAA 


* * 
* FUNCTION 36: SET RANDOM RECORD ii 
* * 


de edd de odtde eode dede cie dee dece dede oe e de e e de e e de de de e e ded n e o RRA 


* Entry Parameters: * 
^a 


Register CL: 2% 
Register DX:  FCB Address 


Returned Value: 


Random Record Field Set 


* 
* 
+ 
* 
* 
dedere dote dee e eode e ee de de de e e de ede de e dn dn ie e e e n gf 


4r 
* 
* 
* 
* 
* 


The Set Random Record function causes rhe BDOS to 
automatically produce the random record vosition of the next record 
to be accessed from a file which has been read or written 
sequentially to a particular voint. The function can be useful in 
two ways. 


Pirst, it is often necessarv to initially read and scan a 
sequential file to extract the positions of various "key" fields. 
As each key is encountered, function 36 is called to compute tne 
candom record position for the data corresponding to this kev. it 
the data unit size is 128 bytes, the resulting record oositíon 
minus one is placed into a table with the xev for later retrieval. 
After scanning the entire file and tabularizing the keys and their 
record numbers, you can move instantly to a particular keved record 
by performing a random read using the corresconding random record 
number which was saved earlier. The scheme is easilv generalized 
when variable record lengths are involved since the orogram need 
onlv store the buffer-relative byte position along with the kev and 
record number in order to find the exact starting position of the 
keved data at a later time. 


A second use of function 36 occurs when switching from a 
sequential read or write over to random read or write. A file is 
sequentially accessed to a particular point in the file, function 
16 is called which sets the record number, and subsequent random 
read and write operations continue from the next record in the 
fils. 
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de ft det dre eoe de oer ode e de dee de de e de de ode cd eoe oe mr de de de oen dne oen Rn t 


* * 
* FUNCTION 37: RESET DRIVE * 
* * 
Je ir da de EEE ode tdeo ode ode de oon ore onde ode oe ode on cd ie dee dee drin ode n dt x gf 
* Entry Parameters: * 
* Register CL: 25H z 
* Register OX: Drive Vector * 
de * 
* Returned Value : X 
e AL: 0054 * 
de eode de oe de ode fe cie dee dee eot oe de eoe de de om e eoe od dee e e e de A 


The Reset Drive function is used to orogrammatically restore 
specified drives to the reset state (a reset drive is not logged-in 
and is in read/write status). The passed parameter in register DX 
is a 16 bit vector of drives to be reset, where the least 
significant bit corresponds to the first drive A, and the high 
order bit corresponds to the sixteenth drive, labelled P. art 
values of "1" indicate that the specified drive is to De reset. 


In order to maintain compatibilitv with MP/M, CP/M returns a 
zero value for this function. 


dr eode dede cipe e de cde ode eode ode ode eode oe de ode de ode dn e deo oen e e o e deo 9n x 


* * 
* FUNCTION 40: WRITE RANDOM WITH = 
sá ZERO FILL » 
dr Yee de ote de sie decine dee dede de e ode dee de eode oe ode cie oe ode oe ode de de dede dn n n n * 
* Entry Parameters: * 


Register CL: 28H vi 
Register DX:  FCB address * 


Register AL: Return Code * 


* 
* 
* 
* Returned Value: 
* 
de odeode dfe de che oe oe oe e oe oe oe oe ode e eee ode n oe oe dede ne noe eoe de oe ode o o o o 


The Write Random With Zero Fill function is similar to the 
Write Random function (function 34) with the exceotion that a 
sreviously unallocated data block is initialized to records filled 
with zeros before the record is written. If this function has been 
used to create a file, records accessed by a read random overation 
that contain all zeros identify unwritten random record numbers. 
Jnwritten random records in allocated data blocks of files created 
using the Write Random function contain uninitialized data. 


it 
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RMR REAR dede e de dede de de e e e d de n m doo 


* * 
* FUNCTION 50: DIRECT BIOS CALL * 
* * 


eodd t md mode dedo oo moe e e ie ie de de de dde e 


* Entry Parameters: * 
* Register Cs 325 2 
* Register DX: BIOS Descriptor * 


oodd ode xo de ode dede d eode e de e e em o e e e EEE 


Function 50 provides a direct BIOS call and transfers 
control through the 3DOS to the BIOS. The DX register addresses a 
five-byte memory area containing the BIOS cali oarameters: 


8-bit l16-bit 16-bit 


where Punc is the BIOS function number, starting at zero, and 
value (CX) and value(DX) are the 16-bit values which would normaily 
5e passed directly in the CX and DX registers with the BIOS cali. 
The CX and DX values are loaded into the 8086 registers before the 
3108 call is initiated. 


dre dece dr de ee de de dee de de de e de ie e de e de EE eH de e e n m e * 


* * 
* FUNCTION Sl: SET DMA BASE " 
* * 


cee eee de dede de dece eode de eode de e e de de e e e e d nde e d e on n 


* Entry Parameters: E 
* Register CL: 33H e 
* Register DX: Base Address * 


EAXRARRERERAR AAA RE eoe dee de o ee e de de dede d d de o 


Function 51 sets the base register for subsequent DMA 
transfers. The word parameter in DX is a Daragraoh address and is 
used with the DMA offset to specify the address. of a 128 byte 
buffer area to be used in the disk read and write functions. Note 
chat upon initial orogram loading, the default segment base is set 
to address of the user’s data segment (the initial value of DS) and 
the DMA offset is set to 0080H, which orovides access to the 
default buffer in the base sage. 
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decode dede ode de cde de de e deo oed o dede ode de e de de e de dede c dee e 


* * 
* FUNCTION 52: GET DMA BASE h 
* * 


deck ode de decode de dede de eode e e de do de e e e e e e de e d 


* Entry Parameters: i 


: Register CL: 34H ‘i 
* * 
*  Returnec Value: n 
y Register BX: DMA Offset * 
* ES: DMA Seament * 
eA dedero de de Fr de de e de de eo o e de e e e ARA 


Function 52 returns the current DMA Base Segment address in 
ZS, with the current DMA Offset in DX. 


4.4.  BDOS Memorv Management and Load Overations. 


Memory is allocated in two Aistinct wavs under CP/M-86. The 
first is through a static allocation mab, located within the BIOS, 
that defines the physical memory which is available on the host 
system. In this way, it is possible to operate CpP/M-86 in a memor" 
configuration which is a mixture of up to eight non-contiguous 
areas of RAM or ROM, along with reserved, missing, or faulty memory 
regions. In a simple RAM-based svstem with contiguous memory, the 
static map defines a single region, usuallv starting at the end of 
the BIOS and extending up to the end of available memorv. 


Once memory is physically mapped in this manner, CP/M-36 
performs the second level of dynamic ailocation to suovort 
-ransient program loading and execution.  CP/M-B6 allows dvnamic 
allocation of memory into, again, eight regions. A request for 
allocation takes place either implicitly, through a program load 
operation, or explicitly through the BDOS calls given in this 
section. Programs themselves are loaded in two ways: through a 
command entered at the CCP level, or through the BDOS Program Load 
operation (function 59). Multiple programs can be loaded at the 
CCP level, as long as each program executes a Svstem Reset 
(function 0) and remains in memory (DL = OLA). Multiple programs 
of this sort only receive control by intercepting interrupts, and 
thus under normal circumstances there is only one transient program 
in memory at any given time. If, however, multiole programs are 
oresent in memory then CONTROL-C characters entered by the overator 
delete these programs in the opposite order in which they wer? 
loaded no matter which program is activelv reading the consoie. 


Any given program loaded through a CCP command can, itself, 
load additional programs and allocate data areas. Sunvose four 
regions of memory are allocated in tne following order: a orogram 
is loaded at the CC? level through an operator command. The CMD 
file header is read, and the entire memory image consistina of tae 
orogram and its data is loaded into region A, and execution begins. 
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This program, in turn, calls the BDOS Program Load function (591 £9 
load another program into region 3, and transfers control to the 
loaded orogram. The region B program then aziocates 25 additional 
region C, followed by a region D. The order of allocation is shown 
graphicallv below: 


-e ee e ee ee ee l a di "Ue md V A FA A m 
—-— -— ——À — cH" We mc c O Rc a m o m d n 
AER a p p —— —À ——À ee AD AP e cum Rn I A 
aH AME aD eee eS GA m Gu O AE ABO c e A 


There is a hierarchial ownership of these regions: the orogram ín 
A controls all memory from A through D. The orocram in B also 
controls regions B through D. The program in A can release regions 
B through D, if.desired, and reload yet another sroaram.  DDT$6, 
for example, operates in this manner by executing the Free Memory 
call (function 57) to release the current program before loading 
another test program. Further, the program in 3 can release 
regions C and D if required by the apolication. It must be noted, 
however, that if either orograsm terminates bv reading a CONTROL-C 
or executing a System Reset (with DL = 00H) then all four regions A 
through D are released. 


A transient program may release a portion of a region, 
allowing the released portion to 5e assigned on the next allocation 
request. The released portion must, however, be at the beginning 
or end cf the region. Suppose, for example, the oroaram in region 
B above receives 800H oaraaraohs at paraaranh location 100% 
following its first allocation request: 


1 

| 

| 
Length = | 
80008 | 
| 

| 

| 


Suppose further that region D is then allocated. The iast 200H 
caragraphs in region C can be returned without affecting region D 
by releasing the 200H oaragraohs beginning at paragraph hase 7008H, 
resulting in 
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| 100046: | | 
Length = | | 
60008 | | Region C 

| ! 
Length = ! TOOOH: ZZL LEII] 
20008 | UPL AALLAR 


— —À — -— — a—À a d nm EP de c ee UR A 


The region beginning at varagraoh address 700H is now available for 
allocation in the next request. Again, note that memorv requests 
will fail if more than eight simultaneous allocated regions are in 
effect., 


Memory management functions beginning at 33 reference a 
Memory Control Block (MCB), defined in the calling brogram, which 
takes the form: 


where M-Base and M-Lenath are either input or output values 
expressed in l6-byte paragrach units, and M-Ext is a returned byte 
value, as defined specifically with each function code. An error 
condition is normally flagged with a OFFH returned value in order 
to match the file error conventions of CP/M. 


*r de de eost oe cite E AAA oe oe de dece eoe ode onde eodein y vx 


* * 
* FUNCTION $3: GET MAX MEM i 
* * 


dr dede dede e fede oe ode oe dede ode dinde eode eo ode de e in cin eoe ode de inde de oe A 9*1 


* Entry Parameters: * 
Register CL: 35H 
Register DX: Offset of MCB 


Register AL: Return Code 
sr de sie eoe eoe de he ode feodo de efe infe o ode eode eon ode ie fe cie ode ode ode de soe x fe n * 


de * 
* * 
* po 
* Returned Value: " 
* * 
de ^ 

Function 53 finds the largest available memory region which 
is less than or equal to M-Length paragraohs. If successful, M- 
Base is set to the base paragraph address of the available area, 
and M-Length to the paragrach length. AL has the value OFTH upon 
return if the no memory is available, and OOH if the request was 
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successful.  M-Ext is set to l if there is additional memory for 
allocation, and 0 if no additional memory is available. 
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AAARARARERA d kd d d dde d RR d e err 


* * 
* FUNCTION 54: SET ABS MAX ll 
* * 
b*ddddhdkd duh rd dede dp eddie t 
* Entry Parameters: " 
* Register CL: 39H z 
+ Register DX: Offset of MCB * 
* * 
* Returned Value: a 
* Register AL: Return Code » 
beéthbthket4zdk4k44 tft ek dd ete dem ee 


Function 54 is used to allocate the largest possicle region 
at the absolute paragraph boundary given by M-Base, for a maximum 
of M-Length varagrapns. M-Length is set to the actual length if 
successful. AL has the value QFFH upon return if no memory is 
available at the absolute address, and 00H if the request was 
successful. 


ERARIO AAA ARA REET E TEETER SS 


* l * 
* FUNCTION 35: ALLOC MEM " 
* * 


od dede d Re dede de eH RRA d de e e o E 


* Entry Parameters: T 
Register CL: 37H 
Register DX: offset of MCB 


Register AL: Return Code 


* 
* 
* 
* 
* 
aheaddddddd dd dd d dede ded d e ded dede dede e RAN 


* 

* 

* 

Returned Value: A 
* 

* 


The allocate memory function allocates a memory area 
according to tne MCB addressed by DX. The allocation request size 
is obtained from M-Length. Function $5 returns in the user's MCB 
the base paragraph address of the allocated region. Register AL 
contains a 00H if the request was successful and a Offi i£ che 
memory could not be allocated. 
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de de fede de de eode ode fece oe sie oe oe ce oe dfe e eode eoe e de oe n cde e de e de e A 


* * 
* FUNCTION 56: ALLOC ABS MEM la 
* * 


foede oder ode ode eode ode ood dede ee de de oe ee RAR 


* Entry Parameters: * 
Register CL: 38H 
Register DX: Offset of MC3 


Returned Value: 


Register AL: Return Code 


* 
* 
* 
* 
* 
de ipod dede dede ode eode eode de in e de de ie e ode Hoe de oe e e en de e de de e o 


k 
* 
* 
* 
* 
* 


The allocate absolute memory function aliocates a memory 
area according to the MCB addressed by DX. The allocation request 
size is obtained from M-Length and the absolute base address from 
M-3ase. Register AL contains a 00H if the request was successful 
and a Of*H if the memory could not be allocated. 


de dede dede de deo e ot eode de e dee ode eode ode ede eoe ode oe de eode de de deo de oe ef 


* x 
* FUNCTION 57: FREE MEM ci 
* * 


ye dee de eode oe de ode eode oie de ode de fede cde ode ode oe ee de eode e o e de d n de de de € 


* Entry Parameters: - 
* Register CL: 39H " 
* Register DX: Offset of MCB * 


dede de e ft eode de e ie ee e de ode eee dee dede ode de oe ede ote e ee dece ede on de f 


Punction 57 is used to release memory areas allocated to the 
orogram. The value of the M-Ext field controls the operation of 
this function: if M-Ext = OFFH then all memory areas allocated bv 
the calling program are released. Otherwise, the memory area of 
length M-Length at location M-Base given in the MCB addressed by DX 
is released (the M-Ext field should be set to OOH in this case). 
As described above, either an entire allocated region must be 
released, or the entire end of a region must De released: the 
middle section cannot be returned under CP/M-36. 
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dedo e deed de ide de de e cie cde de de dee eoe de e c de de de de e e e de e de d e S RAR 


* * 
* FUNCTION 58: FREE ALL MDM * 
* * 
dede dee ode dede ode de de e de de de de e e dede e de dr e e e e e e oe de 
* Entry Parameters: » 
* Register CL:  3AH : 


CARA Rog eode dede e de de ode e ic Re Pe e e e do o EN 


Function 58 is used to release all memory in the CP/M-86 
environment (normally used only Sy tne CCP upon initialization). 


dde Feo dede de de dede eoe de de ree eS eC oe e de e e de e oe 


2 * 
*  F'JNCTION 59: PROGRAM LOAD * 
* * 
odd dede dede dede deed oe efe He de ede de de e de He de ie e e e e ei ATE 
* Entry Parameters: ll 


Register CL:  3BH 
Register DX: Offset of FCB 


Register BX: Base Page Addr 


* 
* 
* 
* 
* 
ACARREAR dede dede de e dde dede c de e e e e e de de e e o e 


* 

r 

* 

Returned Value: * 
* 

* 


Function 59 loads a CMD file. Uoon entry, register DX 
contains the DS relative offset of a successfully ovened FCB which 
names the input CMD file. AX has the value OFFFFH if the >rogram 
load was unsuccessful. Otherwise, AX and 3X both contain the 
paragraph address of of the base Dage belonging to the loaded 
orogram. The base address and segment length of each seqment is 
stored in the base page. Note that upon program load at the CCP 
level, the DMA base address is initialized to the base age ot tne 
loaded program, and the DMA offset address is initialized to 0080R. 
However, this is a function of the CCP, and a function 59 does not 
establish a default DMA address. It is the responsibility of the 
orogram which executes function 59 to execute function 51 to set 
the DMA base and function 26 to set the DMA offset before vassina 
control to the loaded program. 
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The distribution version of CP/M-86 is setup for operation 
with the Intel SBC 86/12 microprocessor and an Intel 204 diskette 
controller. All hardware deoendencies are, however, concentrated 
in subroutines which are collectively referred to as the Basic I/O 
Svstem, or BIOS. A CP/M-86 system implementor can modifv these 
subroutines, as described below, to tailor CP/M-86 to fit nearly 
any 8086 or 3088 overating environment. This section describes the 
actions of each BIOS entry point, aná defines variables and tables 
referenced within the 831085. The discussion of Disk Definition 
mables is, however, treated sevarately in the next section of this 
manual. 


5.1. Organization of the BIOS. 


The BIOS vortion of CD/M-36 resides in the topmost portion 
of the operating system (nighest addresses), and take the Following 
general form: 


1 
| 
| Console | 
Command | 
| Processor | 

| 
| and | 
: Basic | 
ij Disk 
| Operating | 
| Svstem 


Brose y . Sehr herr co 
Disk 
Parameter | 
Tables 

| | yninitialized | 
i Scratch RAM | 


m amp 4 uae de 4D END UNA Am c — — A aum su MED GU dem da Ge mim SEP nn ER GE e UR le m m m 


As described in the following sections, t^e CCP and 3008 are 
supplied with CP/M-85 in hex file form as CPM.ZJB6. In order “oO 
implement C?/M-86 on non-standard hardware, vou muse create a 31298 
whieh performs the functions listed below and concatenate she 
result to the end of tne CPM.486 file. The GENCMD utility is then 
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used to produce the CPM.SYS file for subsequent load ^v the cold 
start loader. The cold start loader itself contains a simplified 
form of the BIOS, called the LBIOS (Loader BIOS), which Loads tne 
resulting CPM.SYS file into memory at the desired location (usually 
04008). The procedure to follow in construction and execution of 
the cold start loader and the CP/M-86 Loader is given in a later 
section. 


Appendix D contains a listing of the standard CP/M-86 BIOS 
for the Intel SBC 86/12 system using the Intel 204 Controller 
goard. Appendix E shows a sample “skeletal” SIOS that contains the 
essential elements with the device drivers removed. “ou may wish 
to review these listings in order to determine the overall 
structure of the BIOS. 


5.2. The BIOS Jump Vector. 


Entrv to the BIOS is through a "jump vector" located at 
offset 25008 from the hase of the operating svstem, as shown 
graphically above, and as listed below. "The jumo vector is à 
sequence cf 21 three-Dyte jump instructions which transfer orogram 
control to the individual BIOS entry points. Although some non- 
essential BIOS subroutines may contain a sinale return (RET 
instruction, the corresoonding jump vector element must 5e present 


in the order shown below. 


Parameters for the individual subroutines in the BIOS ara 
passed in the CX and DX registers, when required. CX receives the 
first parameter, DX is used for a second argument. Return values 
are passed in the registers according to tvoe: Bvte values ae 
returned in AL. word values (16 bits) are returned in BX. 
Specific parameters and returned values are described with each 
subroutine. The BIOS jump vector takes the followna form: 
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25008 JMP BOOT : ARRIVE HERE FROM COLD BOOT 
25038 JMP WBOOT ; ARRIVE HERE FOR WARM START 
2506H JMP CONST ; CHECK FOR CONSOLE CHAR READY 
2509H JMP CONIN : READ CONSOLE CHARACTER IN 
250CR IMP CONOUT ; WRITE CONSOLE CHARACTER OUT 
250FH JMP LIST ; WRITE LISTING CHARACTER OUT 
oo kee IMP PUNCH . WRITE CHAR TO PUNCH DEVICE 
2S15H JMP READER » READ READER DEVICE 
2518H JMP HOME ; MOVE TO TRACK 00 
2313BH JMP SELDSK > SELECT DISK DRIVE 
2919 JMP SETTRK . SET TRACK NUMBER 
25219 JMP SETSEC , SET SECTOR NUMBER 
25248 JMP SETDMA ; SET DMA OFFSET ADDRESS 
2305 JMP READ . READ SELECTED SECTOR 
252AK IMP WRITE . WRITE SELECTED SECTOR 
45 2DR IM? Lists. , RETURN LIST STATUS 
25308 IMP SECTRAN > SECTOR TRANSLATE 
20350 JMP SETDMAB : SET OMA SEGMENT ADDRESS 
233058." JMP GETSEGS . GET MEM DESC TABLE DEPSZT 
2539H JMP GETIOB . GET I/O MAPPING BYTE 
23300 JMP SET:OB . SET I/O MAPPING BYTE 


There are three major divisions in the 3108 jump tadl 
system trejinitialization subroutines, simple character z 
subroutines, and disk 1/0 subroutines. 


e: 
/O 


5.3. Simple Peripheral Devices. 


All simple character 1/0 overations are assumed to De 
performed in ASCII, upper and lower case, with high order (parity 
bit) set to zero. An end-of-file condition for an input device is 
given by an ASCII control-2z (lAH). Peripheral devices are seen by 


CP/M as "logical" devices, and are assigned to ohysical devices 
within the BIOS. Device characteristics are defined below. 


CONSOLE The orincival interactive console which communicates 
with the operator, accessed through CONST, CONIN, 
and CONOUT. Tvvically, the CONSOLE is a device such 
as a CRT or Teletvoe. 


LIST mhe principal listing device, if it exists on. vout 
svstem, which is usually a hard-covy device, such 
as a printer or Teletyse. 


PUNCH The orincival tape punching device, if it exists, 
which is normally a high-speed paber Cave punch or 


Teletype. 
READER mhe orincidai tace readina device, such as 3 simple 


anpè i Tora ar "alet'zoe. 
E m d he Yes rea - or "raiet' =f a 
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Note that a single peripheral can be assigned as the List, 
PUNCA, and READER device Simultaneously. If no peripheral device 
is assigned as the LIST, PUNCE, or READER device, the CBI2S created 
by you may give an appropriate error message so that the system 
does not "hang" if the device is accessed bv PIP or Some other 
transient orogram. Alternately, the PUNCH and LIST subroutines can 
just simply return, and the READER subroutine can return a A JAR 


(etl-2) in reg A tO indicate immediate end-of-file. 


For added flexibility, vou can ovtionallv implement the 
"IOBYTE" function which allows reassignment of physical and logical 
devices. The IOBYTE function creates 4 mapping of logical to 
physical devices which can be altered during CP/M processing (ses 
the STAT command). The definition of the IORYTZ function 
corresponds to the Intel standard as follows: a single location in 
the 8IOS is maintained, called IOBYTE, which defines the logical to 
ohysical device mapping which is in effect at a particular time. 
The mapping is performed DY solitting the IOBYTE into four distinct 
fields of two bits each, called the CONSOLE, READER, PUNCH, and 
LIST fields, as shown below: 


most significant least significant 


we we we a we ii ii a a m m a e a Ie m a 


bits 6,7 bits 4,5 bits 2,2 bits 0,1 


"he value in each field can be in the ranae 0-3, defining 
the assigned source OF destination of each logical device. The 
values which can be assigned to each field are given below 


CONSOLE field (bits 0,1) 
0 - console is assigned to the console orinter (TTY:) 
1 - console is 4ssigned to the CRT device (CRT:) 
2 = batch mode: use the READER as the CONSOLE input, 
and the LIST device as the CONSOLE outout (BAT:) 
3 - user defined console device (UCl:) 


READER field (bits 2,3) 
0 - READER is the Teletype device (TTY:) 
1 - READER is the high-speed reader device (RDR:) 
2 - user defined reader # ] (UR1:) 
3 - user defined reader f$ 2 (UR2:) 


PUNCH field (bits 4,5) 
0 - PUNCH is the Teletyve device (TTY:) 
1 - PUNCH is the high speed punch device (PON :) 
2 - user defined punch # I (MPlt) 
1 - user defined punch # 2 (U?2:) 


LIST field (bits 6,7) 
0 - LIST is the Teletyoe device (Te EE 
1 - LIST is the CR7 device (CRT S) 
> > LIST is the line orinter device (LPT:? 
3 - user defined list device (ULL) 
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Note that a single peripheral can be assigned ag the Lista 
PUNCH, and READER device simultaneously. If no oeripheral device 
is assigned as the LIST, PIINCE, or READER device, the CBIOS created 
by vou mav give an appropriate error message So that the system 
does not "hang" if the device is accessed bv PIP or some other 
transient program. Alternately, the PUNCH and LIST subroutines can 
just simply return, and the READER subroutine car eatucn with a LAH 


(etl-Z} in reg A to indicate immediate end-of-file. 


For added flexibility, you can ovtionaliv implement the 
"IOBYTE" function which allows reassignment of physical and logical 
devices. he IOBYTE function creates à mapping of logical to 
physical devices which can be altered during CP/M processing {see 
rhe STAT command). The definition of the IOQBY"E function 
corresponds to the Intel standard as follows: a singe location in 
the 3108 is maintained, called IOBYTE, which defines the logical to 
ohysical device mapoing which is in effect at a particular time. 
The mapcing is performed bv splitting the IOBYTE into four distinct 
fields of two bits each, calied the CONSOLE, READER, PUNCH, anc 
LIST fieids, as shown below: 


most significant least significant 


- A Se a SS m m M mm ac nU 


A SSS d DERE 


The value in each field can be in the rande 0-3, defining 
the assigned source OF destination of each logical device. The 
values which can be assigned to each field are given below 


CONSOLE field (bits D 1] 
0 - console is assigned to the console printer (TTY:) 
1 - console is &ssigned to the CRT device (CRT:) 
> - batch mode: use the READER as the CONSOLE input, 
and the LIST device as the CONSOLE outout (BAT:) 
3 - user defined console device (UC1:) 


READER field (bits 2,3) 
O - READER is the Teletype device mov] 
1 - READER is the high-speed reader device (RDR:) 
+ - user defined reader à 1 (URl:) 
3 - user defined reader $ 2 (UR2:) 
PUNCH field (bits 4,5) 
0 = PUNCH is the Teletyve device (TTY:) 
1 - PUNCH is the high speed punch device (PUN:) 
2 - user defined punch * 1 (UP1:) 
1 - user defined punch & 2 (UPZ2:) 


LIST field (bits 5,7) 
9 - LIST is the Teletvoe device (TTY:) 
|o = LIST is the CRT device (CRT:) 
3 = LIST is the line printer device (LOT: | 
1 - user defined list device (ULl:) 
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Note again that the implementation cf the TOBYTE is 
optional, and affects only the organization of your CBIOS. No CP/M 
Systems use the IOBYTE except for PIP which aliows access to the 
physical devices, and STAT which allows logical-ohvsical 
assianments to be made and displayed. In anv case, the IOBYTE 
implementation should be omitted until your basic CBIOS is fullv 
inplemented and tested, then add the IOBYT? to increase your 
facilities. 


5.4. BIOS Subroutine Entry Points. 


The actions which must take place udon entrv to each 310S 
subroutine are given below. It should be noted that disk I/O is 
always performed through a sequence of calls on the various disk 
access subroutines which setup the disk number to access, the track 
and sector on a particular disk, and the direct memory access (DMA) 
offset and segment addresses involved in the 1/0 overation. After 
all these parameters have been setup, a call is made to the READ or 
WRITE function to perform the actual I/O overation. Note that 
there is often a single call to SELDSK to select a disk drive, 
followed Sy a number of read or write operations to the selected 
disk before selecting another drive for subsequent operations. 
Similarly, there may be a call to set the DMA segment base and a 
cali to set the DMA offset followed bv several calls which read or 
write from the selected DMA address before the DMA address is 
changed. The track and sector subroutines are always called before 
the READ or WRITE operations are performed. 


The READ and WRITE subroutines should verform several 
retries (10 is standard) before reporting the error condition to 
the BDOS. The HOME subroutine may or may not actually perform the 
track 00 seek, depending upon your controller characteristics; the 
important point is that track 00 has been selected for the next 
overation, and is often treated in exactly the same manner as 
SETTRK with a parameter of 00. 


INIT This subroutine is called directiy by the CP/M-86 

| loader after the CP/M.SYS file has been read into 

memory. The orocedure is responsible for any 

hardware initialization not verformed Sv the boot- 

Strap-loader, setting initial values for BIOS 

variabies (including IOBYTE), orinting a sign-on 

message, and initializing the interruot vector to 

point to the 38DOS offset /ObilH) and base. When 

this routine completes, it jumos to the CCP offset 

(Oh). All seqment registers should be initialized 

at this time to contain the base of the ovderating 
System. 


WBOCT This subroutine is called whenever a oroaram 
terminates bv performing a 3DOS function 40 call. 
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Some re-initialization of the hardware Or 
software may occur here. When this routine 
comrlete«s. it jumps directly to the warm start 
entry point of the CCP (06H). 


CONST Sample the status of the currently assigned console 
device and return OFFE in register: AL if a 


character is readv to read, and 00H in register AL 
if no console characters are readv. 


CONIN Read the next console character into register AL, 
and set the parity bit (high order bit) to zero. 
If no console character is ready, wait until a 
character is typed before returning. 


CONOUT Send the character from register CL to the console 
output device. The character is in ASCII, with 
high order parity bit set to zero. You may want 
“o include a time-out on a line feed or carriage 
return, if your console device requires some time 
interval at the end of the line (such as a TI 
Silent 700 terminai). You can, if you wish, 


filter out control characters which nave 
undesirable effects on the console device. 

LIST Send the character from register CL ‘to ‘the 
currently assigned listing device. The character 
is in ASCII with zero parity. 

PUNCH Send the character from register CL to the 


currently assigned ounch device. The character is 
in ASCII with zero parity. 


READER Read the next character from the currently assianed 
reader device into register AL with zero parity 
(high order bit must be zero), an end of file 
condition is reported by returning an ASCII 
CONTROL-Z (lAH). 


HOME Return the disk head of the currently selected disk 
to the track 00 sosition. If vour controller does 
not have a special feature for finding track 00, 
you can translate tne call into a call to settrk 
with a varameter of 0. 


SELOSK Select the disk drive given by register CL fOr 
further operations, where register C contains 0 
for drive A, 1 for drive B, and so-forth uo to r3 
for drive P the standard CP/M distribution 
version supcorts four drives). On each disk 
select, SELDSK must return in BX t^ base address 
of the selected drive's Disk Parameter Header. 
Por standard flovov disk drives, the content of 
rhe header and associated tables Goes not chance, 
and thus the program segment included 1: che 
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sample CBIOS performs this operation 
automatically. If there is an attempt to select a 
non-existent drive, SELDSK returns BX=0000H as an 
error indicator. Although SELDSK must return the 
header address on each call, it is advisable to 
postpone the actual physical disk Select operation 
until an 1/0 function (seek, read or write; is 
performed. This is due to the fact that disk 
select operations may take place without a 
subsequent disk operation and thus disk access may 
be substantially slower usina some disk 
controllers. On entry to SELDSK it is possible to 
determine whether it is the first time the 
specified disk has been selected. Register DL, 
bit 0 {least significant bit) is a zero if the 
dríve has not been previousiy selected. This 
information is of interest in svstems which read 
configuration information from the disk in order 
to set up a dynamic disk definition table. 


SETTRKÉ Register CX contains the track number for 
subsequent disk accesses on the currently Selected 
árive. You can choose to seek the selected track 
at this time, or delay the seek until the next 
"sad or write actually occurs. Register CX can 
take on values in the range 0-76 corresponding to 
valid track numbers for standard flocov disk 
drives, and 0-65535 for non-standard disk 
subsystems. 


SETSEC Register CX contains the translated sector number 
for subsequent disk accesses on the currently 
selected drive (see SECTRAN, below). You can 
choose to send this information to the controller 
at this point, or instead delay sector selection 
until a read or write operation occurs. 


SETDMA Register CX contains the DMA (disk memory access) 
offset for subsequent read or write operations. 
For example, if CX = 80H when SETDMA is called, 
then all subsequent read operations read their 
data into 80H through OFFH offset from the current 
DMA seqment base, and all subsequent write 
operations get their data from that address, until 
the next calls to SETDMA and SETDMAB occur. Note 
that the controller need not actually support 
direct memory access. If, for example, all data 
is received and sent through I/O ports, the CBIOS 
which you construct will use the 128 byte area 
startina at the selected DMA offset and base for 
the memory buffer during the following read or 
write operations. 


READ Assumina the drive has been selected, the track has 
been set, the sector has been sel, and the DMA 
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offset and segment base nas seen specified, the 
READ subroutine attempts to read one sector based 
upon these parameters, and returns the followina 
error codes in register AL: 


0 no errors occurred 
l non-recoveradie error condition occurred 


Currently, CP/M-86 responds only to a zero or non- 
zero value as the return code. That 15, 1t tbe 
value in register AL is 0 then CP/M assumes that 
the disk operation completed proverlv. If an error 
occurs, however, the CBIOS should attemot at least 
10 retries to see if the error is recoverable. 
When an error is reported the BDOS will norint tne 
message "3D0S ERR ON «x: BAD SECTOR". The 
operator then has the option of typing RETURN to 
ignore the error, or CONTROL-C to abort. 


Write the data from the currently selected DMA 
buffer to the currently selected drive, track, and 
sector. The data should be marked as "non deleted 
data" to maintain compatibility with other CP/M 
systems. The error codes given in tne READ 
command are returned in reaister AL, with error 
recovery attempts as described above. 


Return the ready status of the list device. "sed 
by the DESPOOL program to improve console resoonse 
during its operation. The value 00 is returned in 
AL if the list device is not ready to accept a 
character, and OFFH if a character can be sent to 
the printer. Note that a 00 value alwavs 
suffices. 


Performs sector logical to ohvsical sector 
translation in order to improve the overall 
resoonse of CP/M. Standard CP/M systems are 
shipped with a “skew factor" of 6, where six 
ohvsical sectors are skipoed between each locical 
read operation. This skew factor allows enough 
time between sectors for most vrograms to load 
their buffers without missing the next sector. In 
varticular computer systems which use fast 
orocessors, memory, and disk subsvstems, the skew 
factor may be changed to improve overall resoonse. 
Note, however, that you should maintain a sinale 
density IBM compatible version of CP/M for 
information transfer into and out of your computer 
svstem, using a skew factor of 6. In general, 
SECTRAN receives a logical sector numser in CX. 
and a translate table offset in DX. The sector 
number is used as an index into tne translate 
table, with the resulting ohvsical sector number 
in BX. For standard svstems, the tables and 
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indexing code is provided in tne CBIOS and need 


not be changed. If DX = 0000H no translation 
takes olace, and CX is simpiv copied to BX before 
returning. Otherwise, SECTRAN computes and 


returns the transiated sector number in BX. 


Register CX contains the segment base for 
subsequent DMA read ot write operations. The BIOS 
wili use the 128 byte buffer at the memory address 
determined by the DMA base plus DMA offset durinc 
read and write operations. 


Returns the address of the Memory Region Table 
(MRT) in BX. The returned value is the offset of 
the table relative to the start of the overating 
svstem. The table defines the location and extent 
of physical memory which is available for 
transient programs. Memory areas reserved for 
interrupt vectors and the CP/M-86 operating system 
are not included in the MRT. The Memorv Region 
Table takes the form: 


8-bit 
"nr 
177 Rae 1 Ren 
Wu HONCODE 
s TT mue tena I 
MEET EON HM 


where R-Cnt is the number of Memorv Region 
Descriptors (equal to n+l in the diagram above), 
while R-Base and R-Length give the nDaragrauh hase 
and length of each physically contiguous area of 
memorv. Again, tne reserved interrupt locations, 
normally 0-3FFH, and the C?P/M operating system are 
not included in this map, since these are the 
regions allocated to transient orograms. If all 
memory is contiguous, the R-Cnt field is 1 and n = 
0, with only a single Memory Region Descrivtot 
which defines the reqion. In this case, R-Base 
normaliv addresses the first paragraph boundary 
beyond the last BIOS address, with an R-Length 
field, in oaradraoh units, which allows access to 


the highest paragraph in the region. 


Returns the current value of the logical tO 
ohvsical input/output device byte /IOBYTE) in AL. 
This eight bit value is used to associate ohvsical 
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devices with CP/M-86°s four logical devices. 


Use the value in CL to set the value of the IOBYTE 


SETIOB 
2-ored in the BIOS 


The following section describes the exact layout and 
construction of the disk parameter tables referenced by various 


subroutines in the BIOS. 
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6. BIOS DISK DEFINITION TABLES 


Similar to CD/M-80, CP/M-36 is a table-driven coerating 
system with a separate field-configurable Basic I/O System BIOS). 
By altering soecific subroutines in the BIOS oresented in the 
orevious section, C2/M-86 can be customized for operation on any 
RAM-based 8086 or 8088 microorocessor svstem. 


The 2uroose of this section is to oresent the organization 
and construction of tables within the BIOS which define the 
characteristics of a particular disk svstem used with CpP/M-B6, 
"These tables can be either hand-coded or automatically generated 
usina the GENDEF utility provided with CP/M-86. The elements of 
these tables are presented below. 


6.1. The Format of the Disk Parameter Tables. 


In general, each Gisk drive nas an associated (16-bvte) disk 
parameter header whieh both contains information about the disk 
drive and provides a scratch2ad area fer certain BDOS operations. 
The format of the disk paramecsr header for each "rive is shown 
below 


Disk Parameter Header 
| xn" ! 0000 : 0000 ! 0000 'DIRBUF| DPS ! CSV | ALV | 
16b 16D 16b 16b 16» 16b 165 16b 


where each element is à word (15-bit) value. The meanina of each 
Disk Parameter Header (DPH) element is given below. 


XLT Address of the locical t9 okvsical translation 
vector, if used for this particular drive, OF the 
value 0000H if no sector transiation takes lace 
(i.e, the ohysica. and logical sector numbers are 
the same). Disk drives with identical sector s«ew 
factors share the same rranslate tables. 


0000 Scratchoad values for use within the SDOS (initial 


value is unimportant). 

DIRBUF Address of a 128 byte seratchoad area for directory 
operations within 3DOS. All DPH's address the same 
scratchoad area. 

DPB Address of a disk Sarameter block for this drive. 
Drives with identical disk characteristics acdress 
“ne same disk parameter block. 


CSV. address of a scratzhoad area used for software check 
for changed disks. This address is different for 
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each DPH, 


ALV Address of a scratchvad area used DY the 3DOS tO 
keeo disk storage allocation information. This 
address is different for each DPH. 


Given n disk drives, the DPH/s are arranged in a table whose first 
row of 15 bytes corresponds to drive 0, with the last row 
corresponding to drive n-l. The table thus apoears as 


ncm ELE ie Ec ptam A 


ance AS M o Sr m ate vmm mm m n Un IT 


where the label DPBASE defines ene offset of tne DPY table relative 
to the DS register. 


A responsibility of the SELDSK subroutine, defined in tae 
previous section, is to return the base address of the DPH for tne 
selected drive. The following sequence of overations returns tne 
table address, with a 0000H returned if the selected drive does not 
exist. 


NDISKS EQU 4 NUMBER OF DISK DRIVES 
SELDSK: 

«SELECT DISK N GIVEN 8Y CL 

MOV 8xX,0000H ;READY FOR ERR 


CMP CL,NDISKS ;N BEYOND MAX DISKS? 
JNB RETURN : RETURN IF SO 
SQ <= N < NDISKS 

MOV CH, 0 : DOUBLE (N) 

MOV Bx ,CxX ¡BX = N 

MOV CL, 4 ;READY FOR * 16 

SAL BX,CL ON = N * 16 

MOV CX OFFSET DPBASE 

ADD BX,CX - :DPBASE + N * 16 
RETUSN: RET S3X = .DPES(N) 


The translation vectors (XLT 00 through XL7n-l) are located 
elsewhere in the 3105, and simoly correspond one-for-one with the 
logical sector numbers zero through the sector count-l. The Disk 
Parameter Block (DPS) for each drive is more? complex. A articular 
DPS, which is addressed by cne or more DPH^s, taxes the general 
form 
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| spr !BSR'BLM|EXM| DSM DRM ALOJADLII CRS ^ OFF 
16b 8b 8b 8b 16b 165 BH 8b L6b 15b 
where each is a byte or word value, as shown bv the "Sp" or “ion” 


indicator below the field. 
SPT is the total number of sectors ver rack 


BSH is the data allocation block shift factor, 
determined by the data block allocation size. 


BLM is the block mask which is aiso determined ov the 
data block allocation size. 


EXM is the extent mask, determined by the data block 
allocation size and the number of disk blocx3. 


DSM determines the total storage capacity of the disk 
drive 
DRM determines the total number of directory entries 


which can be stored on this drive ALO,ALli determine 
reserved directory blocks. 


CKS is the size of the directory check vector 


OFF is the number of reserved tracks at ehe beginning of 
the (logical) disk. 


Aithough these table values are produced automatically 5v GENDEF, 
it is worthwhile reviewing the derivation of each field so that the 
values may be cross-checked when necessary. The values of 35% and 
BLM determine (implicitly) the data allocation size BLS, which is 
not an entry in the disk parameter BLOCK. Given that vou have 
selected a value for BLS, the values of 3SH and BLM are shown in 
the table below 


SLS 3SH BLM 
1,024 3 7 
2,048 4 15 
4,096 5 31 
3,192 6 63 
16,384 7 127 


where all values are in decimal. The value of EXM devends uDon 
both the BLS and whether the DSM value is less than 256 or areater 
than 255, as shown in the following table 
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BLS DSM « 256 DSM > 253 
1,024 0 N/A 
2,048 1 0 
4,096 3 1 
3,192 7 3 

16,384 15 7 


The value of DSM is the maximum data block number succorted 
by this particular drive, measured in BLS units. The oroduct SLS 
times (DSM+1) is the total number of oytes held bv the drive and, 
of course, must be within the capacity of the ohvsical disk, not 
counting the reserved operating system tracks. 


The DRM entry is the one less tnan the total number of 
directory entries, which can take on à l6-bit value. The values of 
ALO and ALI, however, are determined by DRM. The two values ALO 
and ALl can together be considered a string of l&-bits, as shown 
below. 


where position 00 corresponds to the high order bit of the byte 
labelled ALO, and 15 corresponds to the low order bit of the Dyte 
labelled ALL. Each bit position reserves a data block for number 
of directory entries, thus allowing a total of 15 Jata blocks to De 
assigned for directory entries (bits are assigned starting at 00 
and filled to the right until oosition 15). Sach directory entry 
occupies 32 bytes, resulting in the following table 


BLS Directory Entries 
1,024 32 times # bits 
2,048 64 times $ bits 
4,096 128 times # bits 
8,192 256 times $ bits 

16,384 512 times + bits 


"^us, if DRM = 127 (128 directory entries), and 3LS = 1924, tnen 
there are 32 directory entries ver block, requiring 4 reserved 
blocks. In this case, the 4 high order bits of ALO are set 
resulting in the values ALO - OFOH and ALl = OOH. 


The CKS value is determined as follows: if the disk drive 
media is removable, then C&S = (DRM+1)/4, where DRM is the last 
directory entry number. If the media is fixed, then set CXS = 0 
(no directorv records are checked in this case). 


Finally, the OFF field determines “he number of tracks whicn 
are skipped at the beginning of the physical disk. This value is 
automatically added whenever SETTRK is called, and can Se used as 4 
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mechanism for skipoing reserved operating system tracks, or for 
partitioning a large disk into smaller segmented sections. 


To complete the discussion of the DPB, recall that several 
DPH/^s can address the same DPB if their drive characteristics are 
identical. Further, the DPB can be dynamicaliv changed when a new 
drive is addressed by simply changing the scinter in the DPH since 
the BDOS copies the DPB values to a local area whenever the SELDSK 
function is invoked. 


Returning back to the DPH for a particular drive, note that 
the two address values CSV and ALV remain. Both addresses 
reference an area of uninitialized memory following the BIOS. The 
areas must be unique for each drive, and the size of each area is 
determined bv the values in tne DPB. 


The size of the area addressed by CSV is CRS bytes, which is 
sufficient to hold the directory check information for this 
oarticular drive. Tf CES = (DRM-1)/4, tnen vou must reserve 
!DRM-1)/4 bytes for directory check use. If CXS = D, then no 
storage is reserved. 


The size of the area addressed by ALY is determined bv the 
maximum number of data blocks allowed for tnis varticular disk, and 
is computed as (DSM/8)-1. 

The BIOS shown in Appendix D demonstrates an instance of 
these tables for standard 8" single density drives. It may be 


useful to examine this oroqram, and compare the tabular values with 
the definitions given above. 


6.2. Automatic Table Generation Using GENDEF. 


The GENDEF utility supplied with CP/M-86 greatly simplifies 
the table construction process.  GENDEF reads a file 


X.DEF 


containing the disk definition statements, and produces an outout 
file 


x.LIB 
containing assembly language statements which define the tables 
necessary to support a particular drive configuration. The form of 
che GENDEF command is: 

GENDEF x 2arameter-lis*t 
where x has an assumed (and unspecified) filetype of DEF, and the 


Darameter-list ooticnallv consists of 
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i sc Generate Disk Parameter Comments 
SO Generate DPBASE CFFSET S 
$2 780, 8080, 8085 Override 
$C0Z (Any of the Above) 


The C parameter causes GENDEF to oroduce an accompanving comment 
line, similar to the output from the "STAT DSK:" utility which 
describes the characteristics of each defined disk. Normally, the 
DPBASE is defined as 


DPBASE EQU 8 


which requires a MOV CX OFFSET DPBASE in the SELDSK subroutine 
shown above. For convenience, the 50 parameter oroduces tne 
definition 


DPBASE EQU OFFSET $ 


allowing a MOV CX,DPBASE in SELDSK, in order to match your 
particular programming practices. The $2 parameter is included to 
override the standard 8086/8088 mode in order to generate tables 
acceptable for operation with 280, 8080, and 8085 assemblers. 


The disk definition contained within x.DEF is composed with 
the CP/M text editor, and consists of disk definition statements 
identical to those accepted by the DISKDEF macro sucolied with 
CP/M-80 Version 2d. A BIOS disk definition consists of the 
following sequence of statements: 


DISKS n 
DISKDEF 0O,... 
DISKDEF 1l,... 
DISKDEF n-1 


. e «bat 


ENDEF 


cach statement is placed on a single line, with octional embedded 
comments between the keywords, numbers, and delimiters. 


The DIS&S statement defines the number of drives to be 
configured with your system, where n is an integer in the range l 
through 16. A series of DISROEF statements then follow which 
define tre characteristics of each lodical disk, 0 through n-1, 
corresvonding to logical drives A through P. Note that the DISKS 
and DISKDEF statements generate tne in-line fixed data tables 
described in the previous section, and thus must be placed in a 
non-executable portion of your 3105, typically at the end of vour 
BIOS, before the start of uninitialized RAM. 


The ZNDEF (End of Diskdef) statement generates tne necessary 


uninitialized RAM areas which are located beyond initialized RAM in 
vour 3IOS. 
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The form of the DISKDEF statement is 


DISKDEF dn,fsc,lsc,fsk£],5ls,dks,dir,cks,ofs,T'Q0! 


where 
an is the logical disk number, 0 to n-1 
sc is the first ohysical sector number (0 or 1) 
lsc is the last sector number 
skf is the optional sector skew factor 
bls is the data allocation block size 
dks is the disk size in dls units 
Gir is the number of directory entries 
cks is the number of "checked" directory entries 
ofs is the track offset to logical track 00 


[0] is an optional 1.4 compatibility flag 


The value "dn" is the drive number being defined with this DISKDEF 
Statement. The "fsc" parameter accounts for differing sector 
numbering systems, and is usually 0 or 1. The "sc" is the last 
numbered sector on a track. when oresent, the “skf” oarameter 
defines the sector skew factor which is used to create a sector 
translation table according to the skew. If the number of sectors 
is less than 256, a sinale-bvte table is created, otherwise each 
transiation table element occupies two bytes. No translation table 
is created if the skf parameter is omitted or equal to 0. The 
"bls" parameter soecifies the number of bytes allocated to each 
data block, and takes on the values 1024, 2048, 4096, 8192, or 
16384. Generally, verformance increases with larger data block 
sizes since there are fewer directory references and logically 
connected data records are ohysicallv close on the disk. Further, 
each directory entry addresses more data and the BIOS-resident ram 
space is reduced. The "dks" specifies the total disk size in "515" 
units. That is, if the bls = 2048 and dks s 1000, then the total 
disk capacity is 2,048,000 bytes. If dks is greater than 255, then 
the block size parameter bls must be greater than 1024. The value 
of "dir" is the total number of directory entries which may exceed 
255, if desired. The "cks" oarameter determines the number of 
directory items to check on each directory scan, and is used 
internally to detect changed disks during system overation, where 
an intervening cold or warm start has not occurred (when this 
situation is detected, CP/M automatically marks the disk read/only 
so that data is not subsequently destroved). As stated in the 
orevious section, the value of cks = dir when the media is easily 
changed, as is the case with a floooy disk subsystem. If the disk 
is permanently mounted, then the value of cks is typically 0, since 
the probability of changing disks without a restart is quite low. 
The "ofs" value determines the number of tracks to skio when this 
varticular drive is addressed, which can be used to reserve 
additional operating system space or to simulate several logical 
drives on a single large capacity ohysical drive. Finally, the [0] 
Darameter is included when file comoatibilitv is required with 
versions of 1.4 which have been modified for higher density disks 
(t72icallv double density). This sarameter ensures that ensures 
chat no directory compression takes place, which would cause 
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incompatibilities with these non-standard CP/M 1.4 versions. 


Normally, this parameter 1s not included. 


sr convenience and economy of table space, the eoecial form 


DISKDEF i45 


gives disk i the same characteristics as a oreviously defined drive 
du A standard four-drive single densitv svstem, which is 
compatible with CP/M-80 Version 1.4, and uoward compatibie 
compatible CP/M-80 Version 2 implementations, is defined using the 
following statements: 


DISKS 4 

DISKDEF 0,1,25,6,1024,213,64,64,? 
DISKDEP 1,0 

DISKDEF 2,0 

DISKDEF 3,0 

ENDEF 


with all disks having the Same parameter values of 26 sectors oer 
track (numbered 1 through 26), with 6 sectors skipped between each 
access, 1024 bytes ver data block, 243 data blocks for a total of 
243k byte disk capacity, 64 checked directory entries, and two 
operating system tracks. 


The DISKS statement generates n Disk Parameter Headers 
(DPH’s), starting at the DPH table address DPBASE generated 5v the 
statement. Zach disk header block contains sixteen bytes, as 
described above, and correspond one-for-cne to each of the defined 
drives. In the four drive standard system, for example, the DISKS 


statement generates a table of the form: 


DPBASE EQU S$ 


DPEO DW XL70,00008,00008,0000H,DIRBUF,DPBO,CSVO, ALVO 
DPEl DW XLTO,0000E,0000H,0000H,DIRBUP,DPBO,CSVl,ALVl 
DPE2 DW XLT0.0000E,00008,0000R, DIRBUF,DP80,CSV2,ALV2 
DPE3 DW XLTO,0000H,0000H,00008,DIRBUF,DPS0,CSV3,ALVj 


where the DPH labels are included for reference ?urzoses to Show 
the beginning tabie addresses for each drive 0 through 3. The 
values contained within the disk parameter header are described in 
detail earlier in this section. The check and allocation vector 
addresses are generated by the ENDEF statement for inclusion in the 
ram area following the BIOS code and tables. 


Note that if the "skf" (skew factor) varameter is omitted 
(or equal to 0), tne translation table is omitted, and a 0000H 
value is inserted in the XLT position of the disk parameter header 
for the disk. In a subsequent call to perform the logical to 
ohvsical translation, SECTRAN recelves a translation table address 
of DX = 00005, and simply returns the original logical sector from 
cx in the BX register. A translate table is constructed when tne 
skf parameter is present, and the (non-zero) table address is 


olaced into the corresponding DPH^s. The table shown below, tor 


E. 
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examole, is constructed when ehe standard skew factor SKÉ = 6 is 
specified in the DISKDEF statement call: 


XLTO EQU OFFSET $ 
DB 1,7.15,19,25,8,.115:17,22424;95;15 721 


DB 2,8,14,20,26,6,12,18,24,4,10,16,22 


Following the ENDEF statement, a number of uninitialized 
data areas are defined. These data areas need not be a Dart of the 
BIOS which is loaded upon cold start, but must be available between 
the BIOS and the end of memory. The size of the uninitialized RAM 
area is determined by EQU statements generated by the ENDEF 
statement. For a standard four-drive system, the ENDEF statement 
might produce 


1C72 = BEGDAT EQU OFFSET S 
(data areas) 
1DB0 = ENDDAT EQU OFFSET $ 
0130 = DATSIZ EQU OFFSET S-BEGDAT 


which indicates that uninitialized RAM begins at offset 1C72H, ends 
at lDBOH-1, and occupies O13CH bytes. You must ensure that these 
addresses are free for use after the system is loaded. 


After modification, you can use the STAT program to check 
your drive characteristics, since STAT uses the disk parameter 
block to decode the drive information. The comment included in the 
LIB file by the SC parameter to GENCMD will match the output from 
STAT. The STAT command form 


STAT d:DSK: 


decodes the disk parameter block for drive d (d#A,...,P) and 
displays the values shown below: 


128 Byte Record Capacity 
Kilobyte Drive Cavacity 
32 Byte Directory Entries 
Checked Directory Entries 
Records/ Extent 

Records/ Block 

Sectors/ Track 

Reserved Tracks 


(* (0 UD PD Ó Co A 3 


++ .. +t LI 


6.3. GENDEP Output. 


GENDEF produces a listing of the statements included in the 
DEF file at the user console (CONTROL-P can be used to obtain a 
printed listing, if desired). Fach source line is numbered, and 
any errors are shown below the liae in error, with a "?" beneath 
the item which caused the condition. The source errors oroduced Dv 
GENCMD are listed below: 


To 
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Bad Val More than 16 disk defined in DISKS statement. 

Convert Number cannot be converted, must be constant 
in binary, octal, decimal, or hexadecimal as 
in ASMBÉ6. 

Delimit Missing delimiter between parameters. 

Dublic Duplicate definition for a disk drive. 

Extra Extra parameters occur at the end of line. 

Length Kevword or data item is too long. 

Missing Parameter required in this position. 

NO Disk Referenced disk not previously definec. 

No Stmt Statement keyword not recognized. 

Numeric Number required in this position 

Range Number in this position is out of range. 

Too Few Not enough parameters orovided. 

Quote Missing end quote on current line. 


Additional errors can occur when preparing input and output files: 


LIB file close overation 
unsuccessful, usuallv due 
to hardware write orotect. 
No space for LIB file. 
Specified DEF file not 
found. 

Cannot create LIB file due 
to too many files on LIB 
disk. 

End of DEF file encountered 
unexpectedly. 


Cannot Close ."LIB" File 
"LIB" Disk. Pull 
No Input File Present 


No ".LIB" Directory Space 
Premature End-of-File 


Given the file TWO.DEF containing the following statements 
disks 2 
diskdef 0,1,26,6,2048,256,128,128,2 
diskdef 1,1,58,,2048,1024,300,0,2 
endef 
the command 


gencmd two Sc 


oroduces the console outout 


DISKDEF Table Generator, Vers 1.0 


1 DISKS 2 

2 DISKDEF 0,1,58,,2048,256,128,128,2 
3 | DISKDEF 1,1,58,,2048,1024,300,0,2 
4 ENDEF 


No Error(s) 


The resulting TWO.LIB file is brought into the skeletal assembly 
language program shown below, using the ASMB6h INCLUDE directive. 
The ASM86 output listing is truncated on the right, but can 5e 
easily recroduced using GENDEF and ASM86: 
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í Sample Program Including T4O.LI 


ae eee 4 RCWON ROO E A AAA EN IA 


SELDSK: 
0000 B9 03 00 MOV CX,OFFSET DPBASE 
= INCLUDE TWO.LI13 
a ; DISKS 2 
= 0003 dpbase equ $ ¡Base O 
= (003 32 00 00 00 doeO0 dw x1t0,0000h :Transl 
= 0007 00 00 00 00 dw 0000h,9000h :Scratc 
s 0008 5B 00 23 00 dw 12000000 Oir Bu 
= QO00F FB 00 DB 00 dw esv0,alv0 ¡Check, 
= 0013 00 00 00 00 doel dw x1*1,0000h rans 1 
= 0017 00 00 00 90 dw 0000h,00COh :Scratc 
= 001B 5B 00 4C 00 dw dirut abbl «Dir Bu 
= 001F 9B Ol 1B Ol dw esvl,alivl «Check, 
; DISKDEF 0,1,26,6,2048,2 
; Disk'0 is CP/M 1.4 Single Densi 
; 4096: 128 Bvte Record Capacit 
; 512: Kilobvte Drive Cavacit 
: 128: 32 Byte Directory Entri 
: 128: Checked Directory Entri 
: 256: Records / Extent 
; 16: Records / Block 
: 26: Sectors / Track 
; 2: Reserved "Tracks 
; 6: Sector Skew Factor 
0023 dpbO equ offset S «Disk P 
0023 1A 00 dw 26 ¡Sector 
0025 04 db 4 ;Slock 
0026 OF db 15 ¿Block 
0027 01 db id .Extnt 
0028 FF 00 dw 255 ¿Disk S 
002A 7F 00 dw 121 ¡Direct 
002€ CO db 192 «AllocO 
002D 00 db 0 ¡Allocl 
002g 20 00 dw HE ; Check 
0030 02 00 dw 2 ;Offset 
0032 LEO equ offset S «Trans! 
0032 01 07 OD 13 db 1713913 
0036 19 05 OB 11 db 25¢ 55 E kt 
003A 17 03 09 OF db 233-4197 42 
003E 15 02 08 OE db 21,2,8514 
0042 14 1A 06 OC db 20,26,5,12 
0046 12 18 04 OA db 18,24,4,10 
004A 10 16 db 15,22 
0020 also equ 342 ;Alloca 
0020 ess0 edu 34 ¿Check 
; DISXDEF 1,1,58,,2048,10 
; Disk 1 is C?/M 1.4 Single Densi 
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= 16384: 128 Byte Record Capacit 
3 ; 2048: Kilobyte Drive  Capacit 
2 A 300: 32 Byte Directory Entri 
z : 0: Checked Directory Entri 
= : 128: Records / Extent 

= ; 16: Records / Block 

= i 58: Sectors / Track 

- : 2: Reserved Tracks 

= 004C dpbl equ offset $ ¡Disk P 
= 004C 3A 00 dw 58 ¿Sector 
= 004E 04 db 4 ¿Block 
= 004F OF db 15 ;Slock 
z 0050 00 db 0 ;Extnt 
= 0051 FF 03 dw 190243 (Disk S 
= 0053 28 01 dw 299 «Direct 
= 0055 F8 db 248 ;AllocO 
= 0056 00 db 0 :Allocl 
x 0057 00 00 dw 0 ¡Check 
z 0059 02 00 dw 2 ¡Offset 
= 0000 Xltl equ 0 ¿No Tra 
= 0080 alsl equ 129 ;Alloca 
* 0000 cssl equ 0 ¿Check 
= A ENDEF 

= : Uninitialized Scratch Memory Fo 
= ; 

= 005B begdat equ offset S "Start 
z 005B dirbuf rs 128 Direct 
= 00DB alvo rs also ;Alloc 
= OOFB csvo rs css ¿Check 
= 0118 alvl rs alsl ;Alloc 
= 0195 csvl rs cssl «Check 
= 019B enddat equ offset $ sEnd of 
= 0140 datsiz equ offset S$-beaqdat ;Size O 
= 0198 00 ab 0 "Marks 


END 
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7. CP/M-86 BOOTSTRAP AND ADAPTATION PROCEDURES 


This section describes the components of the standard C?/M- 
86 distribution disk, the operation of each component, and the 
procedures to follow in adapting CP/M-86 to non-standard hardware. 


CP/M-86 is distributed on a single density IBM compatible 8” 
diskette using a file format which is compatible with all orevious 
CP/M-B0 operating systems, In particular, the first two tracks are 
reserved for operating system and bootstrap programs, while the 
remainder of the diskette contains directory information whicn 
leads to orogram and data files, CP/M-86 is distributed for 
operation with the Intel SBC 86/12 computer connected to flocoov 
disks through an Intel 204 Controller. The operation of CP/M-86 on 
this configuration serves as a model for other 8086 and 8088 
environments, and is presented below, 


The principal components of the distribution system are 
listed below: 


The 86/12 Bootstrap ROM (BOOT ROM) 
The Cold Start Loader (LOADER) 
The CP/M-86 System (CPM.SYS) 


When installed in the SBC 86/12, the BOOT ROM becomes a part 

f the memory address space, beginning at byte location OFFD000H, 
and receives control when the system reset button is depressec. In 
a non-standard environment, the BOOT ROM is replaced by an 
equivalent initial loader and, therefore, the ROM itself is not 
included with CP/M-86. The BOOT ROM can be obtained from Digital 
Research Or, alternatively, it can be programmed from the listing 
given in Appendix B or directly from the source file is included on 
the distribution disk as BOOT.A86. The resvonsibility of the 3007 
ROM is to read the LOADER from the first two system tracks into 
memory and pass program control to the LOADER for execution. 


7.1. The Cold Start Load Operation. 


The LOADER program is a simple version of Co/M-86 that 
contains sufficient file orocessing capability to read CPM.SYS from 
the system disk to memory. When LOADER completes its overation, 
the CPM.SYS program receives control and proceeds to process 
operator inout commands. 


Both the LOADER and CPM.SYS orograms are preceded by the 
standard CMD header record. The 128-bvte LOADER header record 
contains the single group descriotor shown below 
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e o ee ee AI E wen A A ur O dbi Se a E E A diii 


'G-Pora! G-Length | A-Base | G-Min | G-Max | 
| | | xxxxxxxxx | 0400 | xxxxxxx | xxxxxxx | 
8b 165b 18D 16b 16b 


where G-Forn = 1 denotes a code group, "x" fields are ignored, and 
A-Base defines the paragraph address wnere the 300T ROM begins 
filling memory (A-Base is the word value which is offset three 
bytes from the beginning of the header). Note that since onlv a 
code group is oresent, an 8080 memory model is assumed. Further, 
although the A-Base defines the base paragraph address for LOADER 
(byte address 04000H), the LOADER can, in fact be loaded and 
executed at any paragraph boundary that does not overlap CP/M-à6 or 
-he BOOT ROM. The LOADER itself consists of three parts: tae Load 
CPM program (LDCPM), the Loader Basic Disk System (LDBDOS), and the 
Loader Basic I/O System (LDBIOS). Although the LOADER is setup to 
initialize CP/M-86 using the Intel 86/12 configuration, the LDBIOS 
can be field-altered to account for non-standard hardware using the 
same entry points described in a previous section for BIOS 
modification. The organization of LOADER is shown below: 


a am am amp eee als ee ee Oe eS e A A A d 


CS DS ES SS 00008: | JMP 120085 | 


| ( LDCPM) 
| | JMPF CPM ! 
04008: ! 
| (LDBDOS) | 
| 
12008: | JMP INIT | 
| * 9 s é sen 9 è 
| JMP SETIOB ¡ 
| | 
| INIT: .. JMP 0003H | 
| (LDBIOS) | 
1700H: 


where the byte offsets from the base registers are shown at tne 
left of the diagram. GD#l is the Grous Descriotor for the LOADER 
code group described above, followed immediately by a "0" group 
terminator. The entire LOADER program is read by tne BOOT ROM, 
excluding the header record, starting at bvte location 04000H as 
given by the A-Field. ‘Joon completion of the read, the BOOT ROM 
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passes control to location 04000R where the LOADER program 
commences execution. The JMP 1200H instruction at the base of 
LDCPM transfers control to the beginning of the LDBIOS where 
control then transfers to the INIT subroutine. The subroutine 
starting at INIT performs device initialization, orints a sign-on 
message, and transfers back to the LDCPM program at byte offset 
0003B. The LDCPM module opens the CPM.SYS file, loads the CP/M-36 
svstem into memory and transfers control to CPM through the JMPF 
CPM instruction at the end of LDCPM execution, thus comoleting the 
cold start sequence. 


The files LDCPM.H86 and LDBDOS.H86 are included with C9/M-86 
so that you can apoend your own modified LDBIOS in the construction 
of a customized loader. In fact, BIOS.A86 contains a conditional 
assembly switch, called "loader bios," which, when enabled, 
produces the distributed LDBIOS. The INIT subroutine portion of 
LDBIOS is listed in Appendix C for reference purposes. TO 
construct a custom LDBIOS, modify vour standard BIOS to start tne 
code at offset 1200H, and change your initialization subroutine 
beginning at INIT to perform disk and device initialization. 
Include a JMP to offset 0003H at the end of your INIT subroutine. 
Use ASM86 to assemble vour LDBIOS.A86 program: 


ASM86 LDBIOS 


to produce the LDBIOS.H86 machine code file. Concatenate the three 
LOADER modules using PIP: 


PIP LOADER.H86 = LDCPM.H86,LDBIOS.H86,LDBIOS.H86 


to produce the machine code file for the LOADER program. Although 
the standard LOADER program ends at offset 1700H, vour modified 
LDBIOS may differ from this last address with the restriction that 
the LOADER must fit within the first two tracks and not overlap 
CP/M-86 areas. Generate the command (CMD) file for LOADER using 
the GENCMD utility: 


GENCMD LOADER 8080 CODE[A400] 


resulting in the file LOADER.CMD with a header record defining the 
8080 Memory Model with an absolute paragraph address of 400H, or 
byte address 4000H. The LOADER.CMD is copied to the first two 
tracks cf a (scratch) disk under CP/M-80 using the command 


SYSGEN LOADER.CMD 


Alternativelv, if vou have access to an overational CP/M-86 svstem, 
the command 


LDCOPY LOADER 


Copies LOADER to the system tracks. You now have a diskette with a 
LOADER program which incorvorates vour custom LDSIOS capable of 
reading the CPM.SYS file into memory. For standardization, we 
assume LOADER executes at location 4000H. LOADER is statically 
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relocatable, however, and its operating address is determined only 
by the value of A-Base in the header record. 


You must, of course, perform the same function as the BOOT 
ROM ts get LOADER into memory. me boot cperaticn is usually 
accomplished in one of two ways. First, you can orogram vour own 
ROM (or PROM) to perform a function similar to the BOOT ROM when 
vour computer/s reset button is pushed. As an alternative, most 
controllers provide a power-on "boot" operation that reads the 
first disk sector into memory. This one-sector program, in turn, 
reads the LOADER from the remaining sectors anc transfers to LOADER 
upon completion, tnereby performing the same actions as the BOOT 
ROM. Either of these alternatives is hardware-svecific, so vou” ll 
need to be familiar with the operating environment. 


7.2. Organization of CPM.SYS. 


The CPM.SYS file, read bv the LOADER vrogram, consists of 
the CCP, BDOS, and BIOS in CMD file format, with a 128-bvte header 
record similar to the LOADER orogram: 


'G-Porm| G-Length | A-Base | G-Min | G-Max | 
| 1 | xxxxxxxxx | 040 | xxxxxxx | xxxxxxx | 
8b 16b 16b 165 16b 


where, instead, the A-Base load address is caragraph O40H, or byte 
address 0400H immediately following the 8086 interrupt locations. 
The entire CPM.SYS file appears on disk as shown below. 


IGps1!01//////////// f! 


= ap ar ar ry dh màn EM a dd 


CS DS ES SS 00008: | 


(CCP and BDOS) 


aww =- am samm Oe A — 


2500H: ! JMP INIT | 
IMP SETIOB | 
INIT: .. JM? OOOOH | 

saae eem 
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where GD#l is the Group Descriptor containing the A-Base value 
followed by a "0" terminator. The distributed 86/12 BIOS is listed 
in Appendix D, with an "include" statement that reads the 
SINGLES.LIB file containing the disk definition tables. The 
SINGLES.L: file is created by GENDEF using the SINGLES.DEF 
Statements shown below: 


disks 2 

Giskdef 0,1,25,6,1024,243,64,64,2 
diskdef 1,0 

endef 


| The CPM.SYS file is read by the LOADER orogram beginning at 
the address given by A-Base (byte address 9400H), and control is 
nassed to the INIT entry point at offset address 2500H. Anv 
additional initialization, not verformed by LOADER, takes olace in 
the INIT subroutine and, upon completion, INIT executes a JMP 0000H 
to begin execution of the CCP. The actual load address of CPM.SYS 
is determined entirely by the address given in the A-3ase field 
which can be changed if you wish to execute CP/M-86 in another 
region of memorv. 


Similar to the LOADER program, you can modify the BIOS bv 
altering either the BIOS.A86 or skeletal CBIOS.A86 assembly 
language files which accompany your source disk. In either case, 
create a customized BIOS which includes your soecialized 1/0 


drivers, and assemble using ASM36: 
ASM86 BIOS 


to produce the file BIOS.H96 containing your BIOS machine code. 
Concatenate this new BIOS to the CPM.HB6 file on vour distribution 
disk: 


PIP CPMX.H86 = CPM.H86,BIOS.H86 


The resulting CCP, 8DOS, and BIOS hex file is then converted to CMD 
file format by executing 


GENCMD CPMX 8080 CODE!A40] 


in order to produce the CMD memory image with A-Base = 40H. 
Finally, rename the CPMX file using tne command 


REN CPM.SYS = CPMX.CMD 


and oiace this file on your 8086 system disk. Now the tailoring 
process is complete: you have replaced the BOOT ROM by either your 
own customized BOOT ROM, or a one-sector cold start loader which 
brings the LOADER orogram, with your custom LDBIOS, into memorv at 
byte location 04000H. The LOADER program, in turn, reads the 
CPM.SYS file, with vour custom BIOS, into memorv at bvte location 
0400H. Control transfers to CP/M-86, and you are uv and ooeratind. 
CP/M-86 remains in memory until the next cold start operation takes 
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place. 


It should be noted that the two-step boot Operation can be 
avoided if vou construct a non-standarí Aisk drive with sufficient 
space to hold the entire CPM.SYS file on the system tracks. In 
this case, the cold start brings the CP/M-86 memorv image into 
memory at the location given by A-Base, and control transfers to 
the INIT entry point at cffzet 2500E. Thus, intermediate LOADER 


program is eliminated entirely, althouch the initialization found 
in the LDBIOS must, of course, take place instead within the BIOS. 


Since ASM86 and GENCMD are provided in both CCM and CMD 
formats, either CP/M-80 or CP/M-86 can be used to aic the 
customizing process. If CP/M-80 or CP/M-86 is not available, but 
you you have minimal editing and debuaging tools, you can write 
specialized disk I/O routines to read and write the svstem tracks, 
as well as the CPM.SYS file. 


The two system tracks are simple to access, but the CPM.SYS 
file is somewhat more difficult to read. CPM.SYS is the first file 
on the disk and thus it appears immediately following the directory 
on the diskette. The directory begins on the third track, and 
occupies the first sixteen logical sectors of the diskette, while 
the CPM.SYS is found starting at the seventeenth sector. Sectors 
are "skewed" by a factor of six beginning with the directory track 
(the system tracks are sequential), so that you must load every 
sixth sector in reading the CPM.SYS file. Clearly, it is worth the 
time and effort to use an existing CP/M system to aid the 
conversion process. 
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Upon each call to the BIOS WRITE entrv point, the CP/M 3DOS 
includes information which allows effective sector blocking and 
deblocking where the host disk subsystem has a sector size which is 
a multiole of the basic 128-byte unit. The ourvose here is to 
present a general-purpose algorithm which can be included within 
your BIOS which uses the BDOS information to perform the operations 
automaticaliv. 


Upon each call to WRITE, the 3DOS provides the following 
information in register CL: 


0 = normal sector write 
L = write to directory sector 
2 z write to the first sector 


of a new data block 


Condition 0 occurs whenever the next write overation is into a 
oreviously written area, such as a random mode record uodate, when 
the write is to other than the first sector of an unallocated 
block, or when the write is not into the directory area. Condition 
l occurs when a write into the directory area is performed. 
Condition 2 occurs when the first record (oniv) of a newly 
allocated data block is written. In most cases, anulicatíion 
programs read or write multiple 128 byte sectors in sequence, and 
thus there is little overhead involved in either operation when 
blocking and deblocking records since pre-read operations can be 
avoided when writing records. ' 


Aovendix F lists the blocking and deblocking algorithm in skeletal 
form (this file is included on your CP/M disk).  Generaliy, the 
algorithms map all CP/M sector read overations onto the nost disk 
through an intermediate buffer which is the size of the host disk 
sector. Throughout the orogram, values and variables which relate 
to the CP/M sector involved in a seek operation are prefixed by 
"sek," while those related to the host disk svstem are orefixed bv 
"hst." The equate statements beginning on line 24 of Appendix F 
define the mapping between CP/M and the host system, and must be 
changed if other than the sample host svstem is involved. 


The SELDSK entry point clears the host buffer filaa whenever 
a new disk is logged-in. Note that although the SELDSR entry ooint 
computes and returns the Disk Parameter Header address, it does not 
ohysicallv select the host disk at this point (it is selected later 
at READHST or WRITEHST). Further, SETTRK, SETTRK, and SETDMA 
simplv store the values, but do not take any other action at this 
point.  SECTRAN performs a trivial trivial function of returning 
the ohysical sector number. 


The principal entry points are READ and WRITE. These 


subroutines take the olace of vour orevious READ and WRITE 
operations. 
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Sector Blocking and Deblocking Section 8. 


The actual physical read or write takes place at either 
WRITEHST or READHST, where all values have been prepared: hstdsk is 
“he host disk number, hsttrk is the host track number, and hstsec 
is the host sector number (which may require translation to a 
ohysical sector number). You must insert code at this point which 
performs the full host sector read or write into, or out of, the 
Puffer at hstbuf cf length hstsiz. All other manning functions are 
performed by the algorithms. 
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9. A SAMPLE RANDOM ACCESS PROGRAM 


This manual is concluded with a rather extensive, but 
complete example of random access oceration. The program listed in 
Appendix A performs the simple function of readinq or writing 
random records upon command from the terminal. Given that the 
program has been created, assembled, and placed into a file 
labelled RANDOM.CMD, the CCP level command: 


RANDOM X.CAT 


starts the test orogram. The program looks for a file by the name 
X.DAT (in this particular case) and, if found, proceeds to oromot 
the console for input. If not found, the file is created before 
the prompt is given. Each oromot takes the form 


next command? 


and is followed by operator input, terminated 5v a carriage return. 
The input commands take the form 


nw nR Q 


where n is an integer value in the range 9 to 65535, and W, R, and 
Q are simple command characters corresponding to random write, 
random read, and quit processing, resvectively. If the W command 
is issued, the RANDOM proqram issues the prompt 


type data: 


The operator then responds by tvping up to 127 characters, followed 
by a carriage return. RANDOM then writes the character string into 
the X.DAT file at record n. If the R command is issued, RANDOM 
reads record number n and displays the string value at the console. 
If the Q command is issued, the X.DAT file is closed, and the 
program returns to the console command processor. The only error 
message 1S 


error, try again 


The program begins with an initialization section where the 
input file is opened or created, followed bv a continuous loop at 
the label "ready" where the individual commands are interoreted. 
The default file control block at offset 005CH and the default 
buffer at offset 0080H are used in all disk overations. The 
utility subroutines then follow, which contain the princioal inout 
line processor, called "readc." This particular program shows the 
elements of random access processing, and can be used as the basis 
for further program develooment. In fact, with some work, this 
orogram could evolve into a simple data base management svstem. 
One could, for examole, assume a standard record size of 128 oytes, 
consisting of arbitrary fielós within the record. A orogram, 
called GETKEY, could be develoved which first reads a secuential 
file and extracts a specific field defined by the operator. TOF 
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A Samvle Random Access Program Seccion ?. 


example, the command 
GETKEY NAMES.DAT  LASTNAME 10 20 


would cause GETKEY to read the data base file NAMES.DAT and extract 
the "LASTNAME" field from each record, starting at cosition 10 and 
ending at character 20. GETKEY builds a table in memorv consisting 
of each particular LASTNAME field, along with its 16-bit record 
number location within the file. The GETREY program zhen sorts 
this list, and writes a new file, called LASTNAME.KEY, which is an 
alphabetical list of LASTNAME fields with their corresponding 
record numbers. (This list is called an "inverted index" in 
information retrieval parlance.) 


Rename the program shown above as QUERY, and enhance 15 X4 BIC 
so that it reads a sorted key file into memory. The command line 
might appear as: 


QUERY NAMES.DAT LASTNAME.KEY 


Instead of reading a number, the QUERY program reads an 
alphanumeric string which is a particular key to find in tne 
NAMES.DAT data base. Since the LASTNAME.KEY list is sorted, vou 
can find a varticular entry quite rapidly by verformina a “binary 
search," similar to looking up a name in the telephone book. That 
is, starting at both ends of the list, you examine the entry 
halfway in between and, if not matched, split either the upper half 
or the lower half for the next search. Youll quickly reach the 
item you're looking for (in log2í(n) steps) where vou^lil find the 
corresponding record number. Fetch and disvlay this record at the 
console, just as we have done in the program shown above. 


At this ooint you're just getting started. With a little 
more work, you can allow a fixed grouping size which differs from 
the 128 byte record shown above. This is accomplished by keeping 
track of the record number as well as the byte offset within the 
record. Knowing the group size, you randomly access the record 
containing the oroper grout, offset to the beginning of the group 
within the record read sequentially until the group size has been 
exhausted. 


Finally, you can improve QUERY considerably by allowing 
boolean expressions which compute the set of records which satisfy 
several relationships, such as a LASTNAME between HARDY and LAUREL, 
and an AGE less than 45. Display all the records which [it £M1l5 
description. Finally, if your lists are getting too big to fit 
into memorv, randomly access your key files from the disk as well. 
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APPENDIX A: 


RANDOM ACCESS SAMPLE PROGRAM 


t 
AMARA EERE REE ER ERR SERRE ARA RARA 


. t 
J 


. * 
Li 
. *t* 


+ 


* 


Sample Random Access Program for CP/M-RÁ * 


* 


cdd dd d dd d ded deed dede dede e de de dede e ee de de de d de de e m 


, 
. 
? 
* 
t 


. 
, 


BDOS Functions 


10: conino equ H «console input function 

ll: conout equ 2 «console output function 
12: ostring equ 9 .orint string until ^S^ 

13: rstring equ 10 :read console buffer 

14: version equ 12 “return version number 

15: openf equ 15 :file open function 

16: closef edu 16 «close function 

17: makef equ 22 .make file function 

18: readr equ 34 :read random 

19: writer equ 34 ¡write random 

202.4 

oa: 3 Equates for non graphic characters 

244 CE equ Odh carriage return 

243: LE equ Can ¡line feed 

ZA Ss 

25: y 

26: + load SP, ready file for random access 

27: : 

28: cseq 

29: pushf :vush flags in CCP stack 
303 pon ax ¿save flags in AX 
315 cli ;disable interrupts 
32? mov bx,ds «set SS register to base 
33: mov ss,bx ¿set SS, SP with interru 
34: mov so,offset stack ; for 80888 

35: push ax «restore the flacs 
36: poof 

37: ; 

a0: y CP/M-86 initial release returns the file 
39: ; system version number of 2.2: check is 

40: ; shown below for illustration Durdoses. 

Al: 5 

42: mov cl,version 

43: call bdos 

44: - CMD al,20h «version 2.0 or later? 
45: jnb versok 

46: ; bad version, message and go back 
47: mov dx,offset badver 

48: call print 

49: imp abort 

S02 7$ 

51: versok: 
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ancom ACC 


- 3 
Si: 
Sá: 
=o. 
56: 
2g 
58: ; 
54: 
60: 
5l: 
62: 
63: 
64: 
65: 3 
566: ; 
67: 
68: 
69: 
Ts 
71: 
72: 
73: ready: 
Tae c 
MORS 

76: 
rir i- 
78: 
79: 
80: 
81: 
82: 
83: 
B4: 
So: 
86: 
87: 


a 
f 

» 
, 


^ 


-9 j =s o "> =e =e 


wW 
co 
ae 


99; 
100: 
LOL: 
102: 
103: 
104: 
105: 
108: 


“a 


rlooo: 


All Information Presented Here 


loop back to “ready” aft 


correct 


* 
e 


ADDendix 


version for random access 


mov cl, ,openf ¿Oven default fet 

mov dx offset fcb 

call bdos 

inc al ;err 255 becomes zero 
jnz ready 

cannot cren file, so create it 

mov cl,makef 

mov dx,offset fcb 

cali odos 

inc al zerr 255 becomes zero 
jnz readv 

cannot create file, directory Full 

mov dx,offset nospace 

call orint 

jmp abort ¡back to coco 


ar 
-e 


file is ready for roce 
call readcom 

mov ranrec,dx 

mov ranovf,Oh 

cmo al,” Q” 

jnz notq 

quit processing, close 
mov cl,closef 

mov dx,offset fcb 
call 5dos 

inc al err 25 
4 error 

jmps abort 


¿error message, 
"back to cep 


each command 


ssing 


¿read next command 
¿store input recordi 
¿Clear high byte if set 
¿quit? 


file 


5 becomes 0 
retry 


end of quit command, orocess write 


not the quit command, random write? 
cmo al,” WwW’ 
jnz notw 
this is a random write, fill buffer until cr 
mov dx,offset datmsg 
call print ¿data oromot 
mov C», L24 ¿UD to 127 characters 
mov 5x,offset buff ¡destination 
;read next character to buff 
push cx «save looo conntrol 
Dush bx ¿next destination 
is Proorietarv to Digital Research 
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LUT call getchr ¿Character to AL 


108: DOD ox ¿restore destination 
109: DoD Cx ;restore counter 
LIO: cmo AL Ce rend of line? 
111: 32 erloop 

kir 3 not end, store character 

ELS: moy byte ptr [bx] al 

114: inc bx ;next to fill 
Ld. 1900 tiooo ;decrement cx ..looo if 
116: erlooo: 

117: ; end of read loop, store 00 

Lia: mov byte ptr fbx] ,0h 

119: 

L20: ; write the record to selected record number 
lel mov cl,writer 

Léo: mov dx,offset fcb 

l2 call bdos 

124: or al,al ;error code zero? 
1251 32 ready ¿for another record 

1263 mos error ¿message 1£ not 

L2Ti o3 

lz8f 5 

129: ; 

130: ; end of write command, process read 

Laie: 3 

a 9 

133: notw: 

134: ; not a write command, read record? 

135: cmp al,'R^ 

136: 32 ranread 

137: jmps error ¿Skin if nct 

1385 * 

139: 3 read random record 

140: ranread: 

LAL? mov cl,readr 

142: mov dx,offset fcb 

143: call bdos 

144: ot al,al «return code 00? 
145: 52 readok 

146: jmps error 

147: ; 

148: ; read was successful, write to console 
149: readok: 

150: call Crit ;new line 

151: mov cx,128 ¿max 128 characters 
1542: mov si,offset buff ¡next to get 

153: wloop: 

154: lods al ;next character 
1551 and al,07fh ¡mask parity 

155: jnz wloool 

157: jmp ready ¡for another command if 
158: wloonl: 

139: push ex ¿save counter 
160: Dush si ¡Save next to get 
161: cmo dla 7 ;qQraphic? 
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Random Access Sample Program Appendix A 


162: jb Skipw «skip output if not grap 
163: call putcehr soutput character 

164: skipw: 

i55: pop Si 

166: DOD cx 

L67: looo wloop «decrement CX and check 
168: jmp ready 

169: ; 

170< 3 

171: ; end of read command, all errors end-up here 

175. 

LINT 3 

174: error: 

lI9: mov dx offset errmsg 

176: call print 

Er jmo ready 

LIS 4 


179: ; BDOS entry subroutine 
180: bdos: 


181: int 224 ;entry to BDOS if by INT 
1823 ret 

183: 4 

184: abort: «return to CCP 
185: mov c1,0 

186: call bdos suse function 0 to end e 
Lets + 

188: ; utility subroutines for console i/o 

189: ; 

190: getchr: 

191: «read next console character to a 

197: mov el ,conine 

193: cali bdos 

194: ret 

195: 7 

196: putchr: 

197: «write character from a to console 

198: mov cl,conout 

199: mov dl,al «character to send 
200: call bdos «send character 
20.23 ret 

2022.3 

203:. crit: 

204: ;send carriage return line feed 

2051 mov al,cr Carriage return 
206: call putchr 

207: mov al,lf ;line feed 

208: call DUCCHE 

209: ret 

Loea 

2115s Seine: 

2121 sprint the buffer addressed by dx üntll s 
213: push dx 

214: call ere 

215: DOP dx ¿new line 

216: mov cl,ostring 
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Random Access Sample Program Appendix A 
2171 call odos sorint the string 
218: ret 
219: 3 
220: readcom: 
2245 «read the next command line to the conbuf 
244? mov dx .offeer orompt 
2631 call orint "command? 
224: mov cl,rsbtring 
2297 mov dx,offset conbuf 
246: —— cali odos «read command line 
220171. $ command line is present, scan it 
bea: mov ax,0 ¿Start with 0000 
229: mov bx offset conlin 
230: readc: mov dl, [bx] ¿next command character 
Zak inc bx sto next command positio 
Qi21 mov dh. 0 «zero high byte for add 
233: or dl;di «check for end of comman 
234: jnz getnum 
235: ret 
236: 3} not zero, numeric? 
237: getnum: 
238: sub Gl. 0^ 
2391 cmo dl,10 scarry if numeric 
240: jnb endrd 
241: mov Lplp 
242: mul ci «multiov accumulator by 
243: add ax,dx ¿+digit 
244: imps readc ;for another char 
245: endrd: 
246: ; end of read, restore value in a and return value 
247: mov dx,ax ;return value in DX 
248: mov al,-lL{bx] 
249: cmo al, a” «check for lower case 
250: jnb transi 
2914 ret 
252: transl: and al,5fH ¿translate to upper case 
29415 ret 
254: ; 
255: 
256: Template for Page 0 of Data Group 


=a wo Se -> 


25745 

258: 

259: dseq 
260: org 
261: fcb ro 


262: ranrec rw 
263: ranovt rb 
264: buff rb 
265: ; 


Contains default FCB and DMA buffer 


0Sch 

33 «default file control bi 
l «random record sosition 

1 «high order (overflow) D 
128 :default DMA buffer 


266: ; string data area for console messages 


267: badver 
268: nospace 
269: datmsg 
270: errmsg 
271: promot 


“sorry, you need cp/m version 28° 
^no directory spaces” 

“type data: $^ 

“error, try again.S” 

“next command? S” 
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Random Access Sample Program Appendix A 


272: 3} 

273: : 

274: ; fixed and variable data area 

2797. Y 

276: conbuf db conlen ;length of console buffer 
277: cónsiz TS 1 resulting size after read 
278: conlin rs 32 «length 32 buffer 

279: conlen equ offset S - offset consiz 

280: ; 

iUi? rs 31 ;16 level stack 

282: stack cb 1 

293: dd 0 send byte for GENCMD 
284: end 


All Information Presented Here is Proprietary to Digital Research 


92 


APPENDIX B: LISTING OP THE BOOT ROM 


dede dede oe de e dede ode iode deiode ode ode de ode odere dece ode ode oe de oe ende die e hee sd de e ee fede oe cir oie dee odere de e n R x 


Y 
* This is the original BOOT ROM distributed with CP/M 
* for the SBC 86/12 and 204 Controller. The listing 

* is truncated on the right, but can De reproduced by 
* assembling ROM.A86 from the distribution disk. Note 
t shat the distributed source file should always be 

* referenced for the latest version 

* 

fr 


* + + X X* + ox 


door eode fe ode eon ne cde ode cite ode ode e de de od ote dene dre e dn ode efe dede oro de ode dr ote eode de e oe eoe THe Ht 


ROM bootstrap for CP/M-86 on an iSBC86/12 
with the 
Intel SBC 204 PFlooov Disk Controller 


=. => "A “o "a 


Cooyright (C) 1980,198. 
Digital Research, Inc. 
Sox 579, Pacific Grove 
California, 93950 


~. 


w We >u 


de e ir de de de de le eroe ode de de decode de dee e dede ie eoe ode dede oe oe eode e n de nie dede ode e od o $9 
This is the BOOT ROM which is initiated * 
ov a system reset. First, the ROM moves * 
a copy of its data area to RAM at loca- * 
tion 000008, then initializes the segment* 


=< -a ^-^. >. "a 


tiry o X X eee 0 t * OX X t Fe He * 


:* registers and the stack pointer. The " 
various verivuheral interface chips on the* 
SBC 86/12 are initialized. The 8251 * 


serial interface is configured for a 9600* 
baud asynchronous terminal, and the in- * 
terrupt controller is setup for inter- 
rupts l0H-17H (vectors at 00040H-0005PH) 
and edge-triggered auto-EOÍ (end of in- 
terrupt) mode with all interruot levels 
masked-off. Next, the SBC 204 Diskette 
controller is initialized, and track l 
sector l is read to determine the target 
oaradraoh address for LOADER. Finally, 
the LOADER on track 0 sectors 2-26 and 
track l sectors 1-26 is read into the 
target address. Control then transfers 
to LOADER. This brogram resides in two 
2716 EPROM’s (2K each) at location 
OFF000H on the SBC 86/12 CPU board. ROM 
0 contains the even memory locations, anc* 
ROM 1 contains the odd addresses. BOOT * 
ROM uses RAM between 00000H and 0U00FTE * 


"9 ~e ~ag 09 9 3 


=e =$ "d -. "os -- ~. =p» “ue "ow 


t + +t © t + + X $ $4 4 He X 


-— we we =» 
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Listing of the BOOT ROM 


QOFF 
FEOO 


QOFF 


000D 
000A 


00A0 
00A0 
00A0 
QO0A1l 
00A] 
00A2 
00A4 
00A5 
0046 
00A7 
00A8 
00AB8 
90A9 
00AA 
0 QAF 


2580 
0008 


00DA 
00D8 


00D0 
0002 
00D4 
00D6 


00c0 
00C2 


FEOO 


Appendix E 


;* (absolute) for a scratch area, along with* 


«* the sector 1l buffer. * 
jode dede de dee dede de e de de e de dede deiode de ee de e de de de de e dee dei id ede ee 


true equ Offh 
false equ not true 
debug equ true 


«debug = true indicates bootstrao is in same ron 
swith SBC 957 "Execution Vehicle” monitor 
«at FE00:0 instead of FF00:0 


* 
[i 


Cr equ 15 

LE equ 10 

; disk ports and commands 
base204 equ 0a0h 
fáccom equ base204+0 
fdestat equ base204+0 
fdeparm equ base204+1 
faces Lt equ base204+1 
Ederse equ base204+2 
dmacadr equ base204+4 
dmaccont equ base204+5 
dmacscan equ base204+6 
dmacsadr equ base204+7 
dmacmode equ base204+8 
dmacstat equ base204+8 
fdcsel equ base204+9 
fdcsegment equ base204+10 
reset 204 equ base204+15 


:actual console baud rate 
baud rate equ 9600 
“value for 8253 baud counter 


baud equ 768/(baud_rate/100) 

csts equ ODAN :18251 status o 
cdata equ OD8h I7 data oor' 
echo equ 0DOh 8253 PIC chann 
ren equ | tch0-2  ;ch l port 

tch2 equ teh0+4 ¡ch 2 port 

temd equ tch0-6  :8253 command o 
icol equ 0C0h  ;8259a port 0 
icp2 equ 0C2h ;8259a port 1 


IF NOT DEBUG 
ROMSEG EQU OFFOOH  ;normal 

ENDIF 
| TF DEBUG | ¡share orom with 
ROMSEG EQU OFEQQH 
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Li 


* sein 
de D S om g 


0000 
0002 
0004 
2007 
090A 
000D 
ggr 
0012 


9014 
0017 
0019 
0013 
0012 


of 


the SCOT RCM 


UL 
02 
00 


00 


00 
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Appendix 


This long jump srom’d in by hand 


¿seg GECELER ;reset goes to 
: JMPF BOTTOM ¿boot is at DO 
! ZA 00 00 00 FF ;CS = bottom < 
; 19 = 
; EVEN PROM ODD PROM 
; 178 - E 7F8 - 00 
: 79 = 90 7F9 = 90 
; 7FA - FP ¿his is not a 
4 
cseg remseg 
:First, move our data area into RAM at 0000:92 
4 
mov ax,cs 
mov ds,ax :9cint DS to CS for se 
mov SI,drombegin Start of data 
mov DI offset ram start ;oflset ef des 
mov ax,0 
mov es,ax ¡destination segment 
mov CX,data length ;^ow much to 
reo movs al,al ¿move out of e 
mov ax,0 
mov ds,ax ¿data segment now in F 
mov sSs,ax 
mov so,stack offset Initialize st- 


cld 


=e 


- 
- 


- 
L 


"Clear che di: 


NOT DEBUG 


«Now, initialize the console USART anc baud rat 


-» 


mov 
out 
mov 
out 
mov 
out 
mov 
out 
mov 
out 
mov 
out 
mov 
out 


we 


al, QEh 

csts,al «give 8251 dummy mode 
al, 40h 

ests 4. «reser 8251 to acceot 
al , 4Eh 

csts,al «normal 3 Dit asvnca m 
al,37h 

ests,al «enable Tx & RX 

al ,O0B6h 

ecmd,al :8253 ch.2 sauare wave 
ax baud 

tch2,al low of the baud rate 
al,ah 

ech2,al «high of the baud cats 


ES 


. 
t 


;Setup the 3259 Programmable Interrupt Control. 


t 
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Listing of 


0017 
0021 
0023 
0025 
0027 
0029 
0023 
002D 


O02F 
0031 
0033 
0035 
0037 
0039 
903C 
003F 
0042 
0045 
0048 
0045 


004E EZ 


0051 
0054 
0057 
0059 


005€ 
005P 


0052 
0066 
0069 


006€ 
006F 
0072 
0075 
3078 


007C 


0082 


9086 
0088 
908A 
008C 


ALl 


ES 
CO 
1.0 
C2 
lr 
C2 
FF 
C2 


E8 04 


02 
00 
02 


02 
00 


00 


03 
00 


00 


00 


the BOCT ROM 


03 


02 
02 00 00 


02 


restart: 


Appendix 
"OY. al, 35 
Sut 2691.41 :8259a ICW 1 3086 mode 
mov al,lOh 
out icp2,al 78259a ICW 2 vector 8 
mor” al,lFh 
out 1002,41 :8259a ICW 4 auto EOI 
mov al,0FFh 
out: 109,31 :8259a OCW 1 mask all 
;Reset and initialize the iSBc 204 Diskette Int 
¿also come back here on fatal e 
out reset204,AL ¡reset iSaC 204 logic a 
mov AL,l 
out fdOorst,AL ¿qive 3271 FDC 
mov al,0 
out fdcrst,AL ; a reset command 
mov SX,offset soecsl 
CALL sendcom  ;orogram 
mov BX,offset soecs2 


homer: 


CALL sendcom ; 
mov BX,offset svecs3 
call sendcom =; 

"nov 8X,offset home 
CALL execute ;nome drive Q 


ox,sectorl 
mov ax,0 

MOV es,ax 

call setup dma 


mov 
‘segment " i 
mov bx,offset reado 

Call execute ¿get TO Si 

mov es,ABS 


mov bx,0 
Call setup dma 


get loader 


mov ox,cffset readl 

call execute ¡read track Q 
mov bx,offset read2 | 

call execute ;read track 1l 


mov leap segment,tzS 
setup far jumo vector 
mov leab_offset,0 


enter LOADER 


impf dword ptz leao offset 


mov cl,(3X] 
test ćél,cil 
32 return 

call conout 


Shugart SA-300 drive 


Characteristics 


«Offset for first secto 


load addres 
Setup DMA to read loac 
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Listing of the 300T ROM 


008F 
9090 


9093 
0095 
0097 
0099 
0098 
009D 


009E 
00A0 
00A2 
00A4 
00A6 
00A8 


00A9 


QOAD 


0080 
00B4 
0087 
00B9 
008C 
COBE 
0 0C0 
00C3 
00C5 
00C7 
00CS 


00C8 
00CD 
_00CF 


00D3 
00DS 
00D? 


00D9 
00DB 


All 


43 
EJ 


E4 
AB 
74 
8A 
£6 
C3 


E4 
AB 
74 
E4 
24 
C3 


89 


E8 


8B 
8A 
24 
39 
JG 
p. 
B9 
24 
3t 
80 
17 


E 
22 
32 


E4 
24 
74 


3C 
13 


Information Presented Here is 


"à 
ta) 


DA 
01 
PA 
cL 
D8 


DA 
02 
PA 
D8 
7F 


lE 
47 
ar 
00 
Zt 
OB 
80 
OF 
ee 
00 
37 


AO 
cs 
Ci 


Al 
LE 
29 


10 
13 


00 


00 


00 
01 
08 


80 


74 


02 


02 


F8 


conout: 


* 
F 


conin: 


* 
t 
« 
4, 
HE 


execute: 


retry: 


execpoll: 


==. 


-9 


inc BX 
jmo pmsg 


n al,csts 
£ al,l 


in al,csts 
test al,2 
jz conin 

in al,cdata 
and al,7Fh 


Appendix 3 


ret 
;execute command string 4 [3X! 
¿<BX> points to length, 
"followed by Command Dyte 
:foilowed by length-1 parameter 
TOV lastcom,BX «remember what 
"fetrv 12 not r- 
Ball sendcom ;execute the cor 
«now, let s see 
Of status poll 
«for that comma: 
mov BX,lastcom ;coint to commai 
mov AL,1'3X] «get command OD 
and AL, 38h ;drop drive cod: 
mov CX,0800h mask if it wil 
cmo AL,2ch «see if interru 
jb execpoll : 
mov Ccx,3080h ;else we use "n 
and AL,Q0fh ;unless . Doc 
cmp AL, Och «there isn t 
mov AL,O 


ja return 


in AL,FDCSTAT 


0011 for bit in b, 


;anv result at 


toqaled wit: 


and AL,CH 

xor AL,CL ! J2 execpoll 

in AL,fdcrslt «qet result reg 
and AL, len ¡look only at r 
12 return zero means it : 
cmo al,10h 

jne fatal sif other than 
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00DD 
QOEO 


0053 
QOES 
00E7 
O0E9 
OOED 


QOFO 
00F2 
00Fá4 


dors 
0078 
DOTE 
00FP 


0104 


0103 
0105 
0107 
0109 
0108 
010D 
010F 
OILI 
Ll3 
0115 
0117 
0119 
011B 
011D 
o11P 


0120 
0122 
0124 
0126 
0128 
0129 
012B 


012D 


O12F 
0.31 


All 


BB 
ES 


pd 


AS 
75 
38 
E9 


Ca 


B0 
E6 
BO 
E6 
BO 
ES 
8c 
E6 
8A 
E6 
8B 
E6 
8A 
E6 


CS 


Information Presented Here is Proprietary 


AQ 
80 
FA 
OF 


07 
AQ 


¡Se 
DI 


OG 


TE 
- de 


nj "gj 
nj 1 


ex] 
ta] 


02 


mov bx,offset rdstat 
call sendcom 


cd coll: 
in al,fde stat 
test al,80h 
jnz rá coll 
mov bx,last com 
jmp retry ` 
fatal: 


mov ah,0 
mov bx,ax 
mov bx,errtbl[3X] 
; print appropriate error 
call msg 
call conin 
DOD ax 
jmp restart 


return: 
RET 


setubpdma: 
mov AL,0áh 
out dmacmode,AL 
mov al,0 
out dmaccont,AL 
mov AL,40h 
out dmaccont,AL 
mov AX,ES 
out fdcsegment,AL 
mov AL,AH 
out fdcsegment,AL 
mov AX,%3X 
out dmacadr ,AL 
mov AL,AR 
out dmacadr ,AL 
RET 


. 
t 


Appendix : 


«perform read S 


wait for comma: 


:recover last à 
«and try it ove 


; fatal error 
«make 16 bits 
message 

«wait for key S 


«discard unusec 
ethen start all 


:teturn from EX 


«enable dmac 


«set first (dum 


«force read de. 


, 
sendcom: sroutine to send a command str: 


in AL,fdcstat 
and AL,80h 
jnz sendcom 
mov CL, [BX] 
inc BX 

mov al,[BX]) 


sinsure command not bus 
¿get count 


:Doint to and fetch com 


out fdccom,AL ¿send command 
oarmloop: 
dec CL 
jz return «see if anv (more) vara 
inc 8X ¿point to next varamete 
oarmpooll: 
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0132 E4 AQ 
0134 24 20 
0136 75 FA 
0138 8A 07 
013A E6 Al 


n5 
LIE. ES SE T 


tej 


013F 00 00 


014r 02 69 00 


0154 05 35 0D 
0157 08 08 E9 
015A 05 35 10 
0150 FF FF FF 
0150 05 35 18 
0163: PF FF ER 


All Information Presente 


in AL,fdestat 


and 
THz 
mov 
out 
imp 


lastcom 


o ~e O ~ ín -a ~y 4 8 


readstring 


creadtrk3 


creadtrkl 


chome0 
crdstatQ0 
cspecsl 


cspecs2 


especs3 


cerrtbl dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 


24 


parmpoll 
AL,'BX] 


fdcoarm,AL 


varmloop 


rombegin eau offset S 


dw 


db 
db 
db 
ES 


db 
db 
db 
db 
ab 


db 
db 
db 
db 
db 


db 
db 
db 
db 
db 
db 
db 
db 


offset 
offset 
ofíset 
offset 
offset 
offset 
offset 
offset 
offset 
offset 
offset 
of*set 
offset 
offset 
offset 


Appendix 3 


.looo until parm not ful 


:Outout next varameter 
;go see about another 


Image of data to be moved to RAM 


0000h «last command 
3 «length 
527 «read function c 
0 ,*track # 
l 'Sector + 
4 
Eh :read multiole 
0 strack 0 
2 -sectors 2 
25 "through 26 
4 
S dn 
1 track 1 
i «sectors 1 
26 ¿through 26 
2,59h,0 
l,5ch 
$,35h,0dh 
08h,08h,0e9h 
$,35h,l10h 
255,255,255 
5,35h,18ħ 
255,255,258 

erd 

erl 

er? 

eri 

erá 

erS 

ers 

er? 

erg 

er9 

erA 

era 

erc 

erD 

erE 
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0184 


0186 


47 


0D 
20 
20 


0136 
0136 
0186 


0196 


01A4 


0D 


0000 


0200 


0200 
2202 
0206 
020B 


02 


~d 


Yn) (3 


6C 
SF 


ec 
ra 


F 63 
2 6F 


65 


Cerl 
Cer2 
Cer3 
Ceri 


Cer9 


CerA 


CerB 


CerC 


CerD 
CerE 
CerF 


dromend 


dw 


db 


equ 
equ 
equ 
db 


db 


db 


db 


db 


db 


db 


db 


db 


equ 
equ 
equ 


offset ert 


Appendix 


cr,lf, Müll Error 22.0 


cero 
Cero 
cerd 


cr, 12, Clock Error 9 


er,lf,”° Late DMA^,0 


GEILE. ID CRC Srror D 


er lf, Data CBC Error 70 


cr,lf,'Drive Not Ready” ,0 


Cr,lf," Write Prorect”,0 


cr, le; Trk 00 Not Found ,0 


cr,lf,^Write Fault” ,90 


cr,lf,° Sector Not Found” ,0 


cerQ 
cerd 
cero 


equ offset S 


data_length 


=e wa "^ 99 


reserve 
(no hex 


dseg 
org 


ram sS tart 


lastcom 
readO 
readl 
read2 


equ dromend-drombegin 


space in RAM for data area 
records generated here) 


0 
0200h 


equ 
rw 
rb 
r5 
cS 


Un un e r^ uw 


;last command 
«read track 0 


«read TO 
«read Tl 


52-26 
S1-26 


All Information Presented Here is Proprietary to Digital Research 


100 
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Listing of the BOOT RCM Appendix ? 


0210 heme rb 3 «home drive O0 
0213 rdstat rb 2 ¡read status 
0215 svecsl rb 6 
0218 specs2 r 6 
0221 specs rb 6 
0227 errtbl Cw 1n 
0247 er te) length cero 16 
0247 erl equ er0 
0247 er2 equ ero 
0247 eri equ erd 
0257 er4 rb length cerá ;14 
9265 ers rb length cers ee 
0270 ers rb length cers :l3 
027F er? r5 length cer? i14 
0290 er8 r5 length cer8 ie 
02A2 er9 rb length cer9 716 
0282 erA rb length cerA "Ig 
OL erB rb length cer3 714 
02D3 erc 2B length cerC 219 
0247 erD equ ero 
0247 erE equ ero 
0247 er? equ ero 
9256 leap offset Tw d 
9258 leap_segment TW Y 
O2EA tw 32 slocal stack 
032A stack offset equ offset S;stack from here 
; TO Sl read in here 
032A sectorl equ offset S 
032A Ty ro l 
0 32B Len cw 1 
032D ADS cw l ¡ABS is all we < 
032F Min rw i 
0331 Max rw l 
end 
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APPENDIX C:  LDBIOS LISTING 


e e se dede fe cde die ode oe ode oe oe oe oe de ode ie ode eode decode eode coded o ode ode ie oe fe ode de deiode eode de de deiode e oseofe són de 


* 
* 
t 
* 
* 
* 
* 
* 
* 
* 
* 


This the the LOADER BIOS, derived from the BIOS 
program by enabling the "loader bios" condi- 
The listing has been 
edited to remove portions which are duplicated 
in the BIOS listing which appears in Apoendix D 
where elipses "..." denote the deleted portions 
(the listing is truncated on the right, but can 
be reproduced by assembling the BIOS.A86 file 


tional assembly switch. 


provided with CP/M-86) 


"ic se ue fede ede e e die defe e e ie hr eoe dede hee cine iride ide dede ode oe deiode DADA ode e oe oe fe ode oe od on m de wf 


ttt 3X 4 X* + ko o* X ROR 


sre deor dece ede ede de de dee nde de doe de deo eode den de dee fe eode de dede n 


* 


^. 


* 
* 
* 
* 
* 
* 
* 
+ 
* 
* 


" c» ~e Se 9 Se Se Ce Se BE 


-4 "9 "Bb se “» ~. 


“=a 


FFFF true 
0000 false 


Basic Inout/Output System (BIOS) for 
CP/M-86 Configured for iSBC 86/12 with 
the iSBC 204 Flooby Disk Controller 


(Note: this file contains both embedded 
tabs and blanks to minimize the list file 
width for printing purposes. You may wish 
to expand the blanks before verforming 


maior editing.) 
RREREREHERET ERT ode ode ode ode cede ose oe ode e o oe DARA AAA je oe dede ode ode vn d n Xt. 


+ + FE + Y & + $ + OF 


Copyright (C) 1980,1981 
Digital Research, Inc. 

Box 579, Pacific Grove 

California, 93950 


(Permission is hereby granted to use 
or abstract the followina orogram in 
the implementation of CP/M, MP/M or 
CP/NET for the 8086 or 8088 Micro- 
processor) 


equ -l 
equ not true 


» de sre vede ide de decide de de de he de deciete dede detecto moine de eder e d eed ni t 


Loader bios is true if assembling the 
LOADER BIOS, otherwise BIOS is for the 
CPM.SYS file. Blc list is true if we 
have a serial printer attached to 31C3538 
Sdos int is interruot used for earlier 


t t + + + + 
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:* versions. * 
. * * 
r 

ehettek dede de RR UR o d de e de de ded o o o o d t et 


FFFF loader bios equ true 
FFTT v.c list equ true 
QOEO bdos int equ 224 ;BDOS Interrupt 
If not loader bios 
Tui CC c MCCC 
ll 7 | 
ENDIZ ¿not loader bios 
IF loader bios 
A dd M AOS 
1200 bios code equ 1200h ;start of LDBIOS 
0003 cop oflsat equ 0003h ;base of CPMLOADER 
0406 odos ofst equ 0406hÀ ;strioped BDOS entr”? 
ENDIF ;loader bios 
cseg 
org ccpotfset 
COD: 
org oios code 


ARA dede de e eod e de do dede dem eie o mode d o n n 


« * * 
;* BIOS Jumo Vector for Individual Routines * 


>. k * 
r 
dede dede dede de ed d d edo ERS S 


1200 E9 3C 00 imp INIT «Enter from BOOT ROM or LOADER 
1203 E9 61 00 jmp WBOOT Arrive here from BDOS call 0 
1239 E9 64 00 jmo GETIOBF return I/O map byte (IOBYTE) 
123C E9 64 00 jmp SETIOBF :set I/O map byte (IOBYTE) 
ERRATA ode d dee UR ed e ee ee 
. t * 
:* INIT Entry Point, Differs for LDBIOS and * 
;* BIOS, according to "Loader Bios" value . 


e* * 
ed dede do d dd eR e eo d e E Ret 


INIT; ¡print signon messace and initialize ac 
123F 8C C8 mov ax,cs «we entered with a JMP 
1241 8E DO mov SS,ax - CS: as the initial va 
1243 8E D8 mov ds,ax ; DS:, 
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03 


LDBIOS 


1245 


1247 
124A 


124B 
124C 
1247 


lzs1 
1294 
125B 


125C 
Lae 
1262 
1264 


1267 


126A 24 DA 


t^ 


T 
td 


SE 


sting 


CO 


BC A9 16 


FC 


LE 
B8 
8E 


CT 
8c 


LF 


00 
D8 


06 
Of 


15 
SA 
00 
9C 


oF 


00 


80 
16 


14 
00 


ED 


03 06 OB 
00 


Appendix C 


mov es,ax ; and ES: 

suse local stack during initialization 
mov sp, offset stkbase 

eld «set forward direction 


IF not loader bios 


. e A. 


- This is a BIOS for the CPM.SYS file. 


ENDIF ;not loader bios 


IF loader bios 


«This is a BIOS for the LOADER 


push ds «save data segment 
mov ax,0 | 
mov ds,ax point to segment zero 


.BDOS interrupt offset 

mov bdos offset,bdos ofs* 

mov bdos seament,Cs Todos interrupt seg 
oop ds “restore data segment 


~e =>» 


-rm um SED oe oe „man dA ch EA 


ENDIF ;loader bios 


mov bx,offset signon 


call msg sprint signon message 
mov cl,0 «default to dr A: on co 
jmo ccv ;jumo to cold start ent 


WBOOT: jmp ccp+6 «direct entry to CCP at 


IF not loader bios 


! 
! 


O a in eR Ser See 


ENDIF snot loader_bios 


RRA AAA ESTEE EE TEESE SES 


a Y * 
* CP/M Character t/o Interface Routines * 
o * Console is Usart {i82Sla) on iSBC 86/12 * 
po at ports D8/DA * 
« t * 
| ener bene nee e eet ee eee eae EN ee een eee eS EEE ESET ES 


CONST: sconsole status 
in al,csts 


*. * + 
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LD8IOS 


1288 


LLII 


12942 


129€ 


129D 
129 


12A0 
12A2 


12A3 


12A4 
1246 


Listings 


C3 


ES F4 FF 


E8 97 00 


C3 


E4 41 


c3 


BO lA 
GS 


BO 00 


C3 


24 00 


Apoendix C 


const ret; 


ret «Receiver Data Availaol 
CONIN: «console input 
call const 
CONCUT: «console output 
in al,csts l 
CISTOCT: list device outout 
IF blc list 
A 
call LISTST 
. H 
ENDIF POLE LISE 
ret 
LISTST: 'Ooll iist status 
LE bic list 
H m A END Cum cH GRE O AGAR cpm cA E D um ma am oe ee UP Ge m ee ER A es -— B Am e ndi ANA A mc X O ť{—XÁ- EXER 
in al,ists 
Dg i i 
ENDIF ‘Dle LISE 
ret 
PUNCH: :not implemented in this configuration 
READER: 
mov al,lah 
ret return SOf for now 
GETIOBF: 
mov al,0 TTY: for consistency 
ret . ICSYTE not implemented 
SETIOBF: 
ret :iobvte not imolemented 


and al,0 
ret sreturn zero in AL and 


. Routine to get and echo a console character 
: and shift it to upper case 
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uconecho: 
12A7 E8 C9 FF call CONIN :get a console characte 


* «a * 
dede dede RMR de cie ie de der de eod er de de de de de dee ed dee e 
* * 


- +. 99 


" Disk Inout/Output Routines E 
a Y t 
+ 

RRR RR ERRATA de e e de Re e e e d e e n o o 


SELDSK: «select disk given by register 
L2CA 38 00 90 mov bx,0000Ch 
HOME: move selected disk to home position (7 
12EB C6 06 31 15 00 mov trk,9 -set disk i/o to track 
SETTRK: ¿set track address given bv CZ 
1300 83 OE 31 15 moy Ural wwe only use 8 bits of 
i304 C3 ret 
SETSEC: ¿set sector number given DY CX 
1305 88 98 32 15 mov Sect,cl swe only use 8 bits of 
1309 C3 ret 


SECTRAN: ¡translate sector CX usina table at (D 
130A 8B D9 mov bx,cx 


SETOMA: ¿set DMA offset given Dy CX 


1311 89 OE 2A 15 mov dma acr,CX 

1319 Cs ret 
SETDMAB: ¿set DMA segment given bv CX 

1316 89 OE 2C 15 mov dma seg,CX 

ESA CJ ret 
GETSEGT: ¡return address of physical memory ta 

1318 BB 38 15 mov bx,offset sea table 

1318 C3 ret 
LER RE RARER REE EER ETRE e dee HAE ESN ES 
e * * 
-* All disk I/O parameters are setup: the ” 
.* Read and Write entry points transfer one 7 
;* sector of 128 bytes to/from the current * 
.* DMA address using the current disk drive * 
. dr * 
EERE RRR REET ETE EERE EERE UR OI HH Ren 
READ: 

L3LF 80 12 mov al,l2h «basic reac sector comm 

1321 EB 02 imps r w common 
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WRITE: 
1323 BO OA mov al,0ah «basic write sector com 


ft w common: 
1329 35 27 "La mov bx,offset io com ;point to command 


QAO OR OR RO REOR UR RO E ER UK IG ERG RU HU RR Io Ho o o rr e n 


. Y 4 
* Data Areas * 
+ 


aa = ~. 
* 


dde Re dee eode dede ode ode ode iore de dede de ee de de ce dede oc dee de d de n e eile 


1415 data offset equ offset S 
dseq 
org data offset :contiguous wit 
IT loader Dios 
ers e n UM 
1415 OD OA OD OA signon db cr.lf.er,l1t 
1419 43 50 2F 4D 2D 38 db 'CP/M-96 Version 2.2^,crc , 1£,0 


36 20 56 65 72 73 
69 6F 6E 20 32 2E 


32 0D OA 00 
1 
poc s aeu; c7 
LE not loader bios 
_ oo. ME MEM 1 
" & ok % | 
qaa Dui "Las Fede iP — O 
142F OD OA 48 6F 6D 65 5ad hom db cr,lf,' Home Error^,cr,lf,0 
. | include sinales.lib ¿read in disk defir. 
- ; DISKS 2 
= 1541 dpbase equ S :Sase of Disk F 
= 1668 00 db 0 Marks End of ¥ 
1669 loc stk rw 32 ¡local stack for initialization 
16A9 stkbase equ offset $ 
16A9 00 db o — fill last address for GENCMD 
LEER EERE EE TEENIE EEE EE TEER don 
e z 
jt Dummv Data Section * 
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* 


. Y 
-ARRARAETER E Stee TEE EA EEE dede node ode tod ide code deo tor x 
0000 dseg 0 «absolute low memory 
org 9 ; (interrupt vectors) 
END 
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APPENDIX D: BIOS LISTING 


eR TERR RRR REAR RERA RENEE RATTAN TERT EES 


* 
"his is the CP/M-86 BIOS, derived from the BIOS * 
orogram by disabling tne "loader 2ios" conci- * 
tional assembly switch. The listing has been * 
-runcated on the right, but can be reproduced * 
by assembling the B8IOS.AB6 file orovidec with * 
CP/M-86. This BIOS allows CP/M-86 overation * 
with the Intel S3C 86/12 with the SBC 204 con- * 
«roller. Use this BIOS, or the skeletal CBIOS * 
listed in Appendix E, as the basis for a cus- * 
tomized implementation of CP/M-86. * 
provided with CP/M-86) * 

* 

* 


t+ + + © X X 0  o* 


dex Ro Re OR OR RT RR e e RR RO RAR RARA NEE ESE ES 


deo dde dod dede de dede e de dde de de de deo e dece de de de e de dee e e e e oe 


Basic Input/Output System (RIOS) för 
CP/M-86 Configured for iSBC 86/12 with 
the iSBC 204 Floppy Disk Controller 


sea wa -— +s "o. bo “e =e 


tabs and blanks to minimize the list file 
width for printing purposes. You may wish 
to expand the blanks before performing 
major editing.) 

add dd dede dede dede dededede dede e de dee dede dei dee d dede dee de 


+ y 3 + + Ro ot + + 


* 

* 

fr 

+ 

* 

* (Note: this file contains both embedded 
* 

+ 

* 

+ 

* 


=» -- =e - e 


Copvright (C) 1980,1981 
Digital Research, Inc. 

Box $79, Pacific Grove 

California, 93950 


=e -- 


my c ==. 


(Permission is hereby granted to use 
or abstract the following program in 
the implementation of CP/M, MP/M or 
CP/NET for the 8086 or 8088 Micro- 
orocessor) 


"» “+ 99 


~. 


~+ 


FTFFF true equ -1 
0000 ^. false equ not true 


. bxddtdktkdtdadkd d A ded dee ded deem ede ede d edem 


. Y * 
;* Loader bios is true if assembling the a 
,* LOADER BIOS, otherwise BIOS is for tne * 
:* CPM,SYS file. Blc list is true if we * 
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0000 
EFES 
00E0 


2500 
0000 
0B06 


00DA 
00D8 


0041 
0040 
0060 


00A0 


00A0 
JOAO 
00Al 
O0AL 


Appendix D 


:* have a serial printer attached to BLC8538 * 


:* Bdos int is interruot used for earlier i: 
T 

;* versions. " 

2 * 


, 
[eSATA ESAS SASS eS TTA 


loader bios equ false 

lE- LISE equ true 

bdos_int equ 224 ;reserved BDOS Interrup 
IS not loader bios 

ee xum | 

bios code equ 2500h 

ccp offset equ 0000h 

bdos ofst equ 0B06h ;8DOS entry point 


- 
t l 
* am am mp sd dto E ee E X ee ee ee ee ul eoo E ee LL ee A POS bd e eee ee ee ae 


ENDIF ;not loader bios 


LE loader bios 
bios code equ 1200h ;start of LDBIOS 
ccpo offset equ 0003h ;base of CPMLOADER 
bdos_ofst equ 0406h ;stripped BDOS SARET 


, 
H mE qp am mr reim a am a Gb r du ue SE aa ue a UE GR a m e A Sd m ms 


ENDIP ¡loader bios 


csts equ 0DAh ;18251 status port 
cdata equ OD8h ; * data cort 

IF blc [rst 
;| | 
lsts equ 41h ;2651 No. 0 on BLC8538 
ldata equ 40h ; " " T Om Z 
blc reset equ 60h ;reset selected USARTS 


r 


* e e e ar a et Bee ARD ANA eee ca d END WEN Ge hm cadum cda ee GAP qm wee ee E D am m GRE GE RR eee -— i oe 


ENDIF ;ble_list 


GRRE dedo ede ed EE e e ded e AREER EEE ei o or 


. Y * 
ck Intel iSBC 204 Disk Controller Ports * 
.* te 


+ 


oR RRR REET RE ERATE ERE RARA RARA 


base204 equ O0aO0h ;SBC204 assigne 
fdc com equ base204+0 :8271 FDC out C 
¿de stat equ base204+0 :8271 in statu* 
fdc_varm equ base204+1 ;8271 out parar 
fde_rsit equ base204-1 :3271 in result 
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00A2 
00A4 
00A5 
00A6 
00A7 
00AB 
0048 
90A9 
QOAA 
SIAP 


O00A 


200D 
000A 


2500 E9 
2503 E9 
2506 59 
2309 E9 
290€. B3 
250F E9 
2912 ES 
2915 E 

2518 E9 
251B E9 
25IE- ES 
fora Bd 
2524 E9 
492 B9 
252A E9 
252D £9 
2530 E9 
2533 E9 
2536 E9 
2539 E9 
233C B9 


tdc rst 
dmac adr 


¿mac 


cont 


dmac scan 
mac sadr 
dmac mode 
dmac stat 
rac sel 

fdc segment 
reset 204 


max retries 


CI 


LE 


cer: 


cseg 
org 


Org 
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equ base294+2 :8271 out reset 
equ base204+4 :8257 DMA base 
equ base204+5 :8257 out contr 
equ base204+6 ;:8257 out scan 
ecu base204+7 :8257 out scan 
equ base204-8 :8257 out mode 
equ base204+8 :8257 in status 
equ base204+9 SFDC select voor 
equ base204+10 ;seament addres 
equ base204+15 ¡reset entire i 
equ 10 «max retries on 

¡before perm er 
equ Odh ¿carriage retur 
equ Dan | ;line feed 


ccpoffset 


Dios code 


; dede do de de Hd or e ide dq d de deed dece idee ee mm 


.* 
t 


* 


-* BIOS Jump Vector for Individual Routines * 


>. * 
é 


de 


` de de de 9e eode dede ose deiode ode ode de de site ode ode de oe ode oe eode e eoe eode de ede de dede oe dede n n x 
t 


jmp 
jmp 
jmo 
jmp 
jmp 
jmo 
jmp 
jmp 
jmo 
jmo 
jmp 
jmo 
jmp 
jmo 
jmp 
jmp 
Imo 
jmp 
jmp 
Imo 
jmp 


® 


^ -+ -+a =e 


* 


-* 


- 


|* Bios, 


INIT 
WBOOT 
CONST 
CONIN 
CONOUT 
LISTOUT 
PUNCH 
READER 
HOME 
SELDSK 
SETTRK 
SETSEC 
SETDMA 
READ 
WRITE 
LISTST 
SECTRAN 
SETDMAB 
GETSEGT 
GETIOBF 
SETIOBF 


«Enter from 3007 ROM or LOADER 
-Arrive here from BDOS call 0 
sreturn console keyboard status 
«return console kevboard char 
write char to console device 
“write character to list device 
¡write character to punch devic 
«return char from reader device 
«move to trk 00 on cur sel driv 
:select disk for next rd/write 
«set track for next rd/write 
:Set sector for next rd/write 
«set offset for user buff (CMA) 
«read a 128 byte sector 

«write a 128 bvte sector 
sreturn list status 

xXlate logical-»ohvsical sector 
«set seg base for buff (DMA) 
«return offset of Mem Desc Tabl 
return 1/0 mao byte (IOBYTE 
«set I/O man byte (IOBYTE) 


MR RRA de RR e Re deco de de ode cir eode eode seien eode de de e e dee de re de de eon de 


* 


* INIT Entry Point, Differs for LDBIOS and * 
according to "Loader 8ios" value * 


t 


. TRAER ode dede de dede e eode e de de deje de e e de de e e e d 
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253F 
2541 
> 2543 
2345 


2547 
= 254A 


2548 
254C 
254F 
2331 


4324 
2999 
2330 
2560 
2563 
2566 


pm 2568 
256E 


- 256F 
227 
25143 
2515 
E. 2577 
2579 
257B 
257D 


8c 
8E 
8E 
8E 


BC 
FC 


BO 


30 
E6 
BO 
E6 
BO 
E6 


C8 
DO 
D8 
CÓ 


E4 


00 
CO 


06 
QE 
04 
00 
FE 
AS 


06 


PF 
60 
4E 
42 
3E 
42 
37 
43 


29 


00 


00 00 8D 25 
02 00 

00 

00 

01 


80 03 06 OB 


INIT: 


Appendix D 


;Orint signon message and initialize hz 


mov ax,cs ewe entered with a JMPF 
mov ssS,ax ; CS: as the initial va 
mov ds,ax ; DS:, 

mov es,ax : and ES: 


«use local stack durina initialization 
mov sp,offset stkbase 
cld ;Set forward direction 


IF not loader bios 


^ —-— "mo a oe de CD CA due und mdr anda illo RE and n A nin ndum m A Ee LA MU uim A dAH quee dem (MP NS VERA ANE O UEM LA cde ls um um UR d d E 


This is a BIOS for the CPM.SYS file. 
Setup ail interrupt vectors in low 
memory to address trap 


se =e =e 


push ds ¿Save the DS register 
mov ax,0 

mov ds,ax 

TOV es,ax ¿Set ES and DS to zero 


; Setup interrupt 0 to address trao cou: 
mov intÜ offset,offset int trap 

mov int0 segment,CS 

mov di,4 

mov si,0 ¿then propagate 

mov cx,510 ¡trab vector to 

rep movs ax,ax ¡all 256 interrupts 

; BDOS offset to orover interrupt 

mov bdos offset,bdos ofst 

pop ds ;restore the DS regis-*: 


e *de fe de de e cde ode oe e de once de de DA dese de DA AAA ode DAA ode eoe oe ode oon ALA dede ode fe n n x 


me 9$ "4 we “Oo nę — M © 


* + + y + © & 


Li 


National "BLC 8538" Channel O for a serial* 
9600 baud printer - this board uses 8 Sig-* 
netics 2651 Usarts which have on-chip baud* 
rate generators. i 


* 


*r se se desde de dese ode cda ode e ode de se de sie oe cde cie ode eode ode de cde de fe oie ode decode cde ode oe defe eot KAKA 


mov al,0FFh 

out ble reset,al ¡reset all usarts on ! 
mov al,4Eh 

out ldata+2,al ¿set usart 0 in async i 
mov al,3Eh 

out ldata+2,al ¡set usart Q to 9600 x 
mov al,37h 

out ldata-3,al ¡enable Tx/Rx, and see 


cr ee ee ee chium uu d ee NA 


ENDIF «not loader dios 


IF loader Dios 


. aA cde dE dE ee ee O ee ee GUN XD AND NND NND NDS UNDA NA ND 6 AM E A RE 2 E e GUN de ums es ee dum ndm cis uum adm ani auf ndm dag mda ln E 
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Aooendix D 


for the LOADER 
«save data segment 


«This is a BIOS 
push ds 

mov ax,0 

mov ds,ax ¿point to segment zero 
:BDOS interrupt offset 

mov bdos offset,bdos ofst 

mov bdos segment,CS ;bdos interrupt seg 


| pon ds «restore data segment 
ENDIF ;loader dics 
257F BB 44 27 mov bx,offset signon 
2532 EB 66 00 call umsg sprint signon message 
2585 Bl 00 mov cl,0 «default to dr A: on co 
2587 E9 76 DA jmp cco jump to cold start ent 
258A E9 79 DA WBOOT: imp ccp-*6 «direct entry to CCP at 
I? not loader 5ios 
peso Ed 
int trap: 
258D FA ell «block interrupts 
2388 8C C39 mov ax,cs 
2590 8E D8 mov ds,ax «get our data segment 
2592 BB 79 27 mov bx,offset int trp 
2595 E8 53 00 call omsg 
2598 F4 nit shardstoo 
1 
ENDIF :not loader bios 
QE Rd d dH doi de i e d o em 
+ * 
q CP/M Character I/O Interface Routines * 
p? Console is Usart (i8251a) on :SBC 86/12 * 
E at ports D8/DA * 
p = 
RARA AAA AREA RARE 
CONST: console status 
2599 E4 DA in al,csts 
259B 24 92 and al,2 
259D 74 02 jz const ret 
259F OC FF Or Alyda “return non-zero if RDA 
const_ret: 
25AL C3 ret «Receiver Data Availabl 
CONIN: «console :inout 
25A2 E8 F4 FF call const 
25A5 74 FB 3z CONIN «wait for RDA 
25A7 E4 D8 in al,cdata 
25A9 24 7F and al,7fh read data and remove y 
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¿SAD 


25AC 
25AE 
2380 


-- Aras 
£2D« 


2 5B4 
25B6 


25B7 
258A 
238€ 
25BE 


2381 
2063 
2505 
230] 
2269 


25CC 
¿3CE 


29CF 
25Di 


"E 2 5D2 


2503 


C3 


=o 
7 4 
BA 
£6 


c3 


E4 
24 
3C 
75 
oc 


Cs 


30 
C3 


BO 
C3 


Ca 


24 


DA 
01 
FA 


my 
Na aka 


D8 


„4 


o 
40 


41 
8l 
81 
0A 
FF 


00 


90 


90 


CONOUT: 


Gig hula s 


PUNCH: 
READER: 


GETIOBF: 


SETIGQME: 


Appendix D 


rec 


console outout 
in al,csts 


and al,l ¿get console status 
jz CONOUT Walt for. TSE 
mov al,cl 
out cdata,al «Transmitter Buffer Emo 
ret «then return data 
«list device outout 


Dr ole List 


call LISTST 


12 LISTOUT ¿wait for orinter not b 
mov al,cl 
out ldata,al «send char to TI 810 


ENDIF ;blc, list 


coll list status 


in al,lsts 


and al,81h :look at both TxRDY anc 
cmo al,81h l 

jnz zero cet ‘either false, orinter 

or al,255 "both true, LOT is reac 
ENDIF BIC list 

ret 


;nót implemented in this configuration 


mov al,lah 


ret ¿return EOF for now 
mov al,0 TTY: for consistency 
ret :IOBYTE not implementec 
ret :iobvte not implementec 


zero ret: 


and al,0 
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2505 


LES 
SED 
£75 
25Fl 
25F3 
2355 
25F7 


C3 


SA 


~t 


8A 


- 
-— 


EB 


11] 
"rj 


tsj 
tj 


00 


00 


28 


28 


ret 


Appendix D 


"return zero in AL and 


; Routine to get and echo a console character 


- 
, 


and shift it to upper case 


nconecho: 


omsg: 


Call CONIN «get a console charact: 
push ax 

mov cl,al «Save and 

call CONOUT 

DOD ax pecho to console 

ono al. a 

jb uret ¿less than “a” is ok 
emp al,^z^* 

ja uret greater than "2" is ck 
sub al,'a'-"A' ¡else shift to caos 


ret 


utility subroutine to orint messaces 


mov al,fSXi ¿set next charn from me: 
test al,al 

J2 teturi cite zero return 

mov CL , AL 

call CONCUT rS LAE It 

inc BX 

3mos omsg «next character and lor 


z hec dde noo de dee die eed e dece de cde eode de eode deo oe deo eedem de dr e e d n v 


* 
t 
* 


`$ -+ =F 


* 


Disk Inout/Output Routines al 
* 


y eode dco dre dede de de ode ede RECREAR EA n AEREA e A EE 


SELDSK: 


sell: 


return: 


«Select disk aiven by register 
mov bx,0000h 
emo El, Z 
jnb return 
mov al, 80h 
emo clo 
jne sell «drive l if not zero 
mov al, 40h ¡else drive is 0 
mov Sel mask,al ;save drive select mas? 

7 ;now, we need disk pare 


«this BIOS only suoocor* 
«return w/ 0000 in BX : 


mov ch,0 

mov bx,cx :;3X = word(CL) 

mov <l,4 

shl bx,cl ;multioly drive code * 
¿create offset from Disk Parameter Base 
add bx,offset do base 


rd de 
:-1 
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261A 
2851-7 
2622 
2625 
2627 
262A 
262D 


2547 
2033 


2634 
2638 


2639 
263B 
263D 
263F 


2640 
2644 


2645 
2649 


254A 
264D 


264E 
2650 


2652 


2634 
2557 


C6 
BB 


" 


a 
74 
BB 


EB 


88 


88 
C3 


88 
03 
8A 
s 


89 
C3 


89 
C3 


BB 
Cs 


BO 
EB 


BO 


BB 
88 


DS 


LE 


QE 


p 


L4 
02 


OA 


6A 
47 


óC 28 00 


28 
00 


27 
p 


T 
de 


6C 


6D 


67 


28 


28 
01 


28 


28 


28 


28 


Appendix D 


ROME: «move selected disk to home vosition [T 
mov trk,0 «set disk i/o to track 
mov bx,offset hom com 
Call execute 


iz return «home drive and return 
mov bx,offset bad hom ¡else print 
call omsg : “Home Error” 

jmps home ;and retrv 


SETTRK: ¡set track address given bv CX 
mov trk,cl «we only use 8 bits of 
ret 


SETSEC: ;set sector number given bv cx 
mov sect,cl ¿we only use 8 bits of 
ret 


SECTRAN: ¿translate sector CX usina table at [D 
mov bx,cx 
add bx,dx «add sector to tran tac 
mov b5l,[bx] «get logical sector 
ret 


SETDMA: ¿set DMA offset given by CX 
mov dma adr,CX 
ret 


SETDMAB: :set DMA segment qiven bv CX 
mov dma seg,CX 
ret 


GETSEGT:  ;return address of phvsical memory ta 
mov ox,offset seg table 
ret 


Je de eode ie decode dee ode de oc ode ode de de feci eie oe eoe de ode oe de ode ede ede diede e dee eoe e n n dn 


* 
* * 
* All disk I/O parameters are setuo: the * 
* Read and Write entry points transfer one * 
* sector of 128 bytes to/from the current * 
* DMA adéress using the current disk drive * 
* * 
* ^r 


de de de rode e dt ode ce ode defe oe oe de Re oe oe oe oie dede e de eode dee e e de eee e de de dn dee o x 


mov al,12h «basic read sector comm 
jmps t w common 


mov al,0ah «basic write sector com 


r w common: 
~~ mov bx,offset ic com ;coint to command 
mov bvte otr l[85X!,al ¡out command into 
: fail into execute and return 
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execute: 


t 
* 
+ 
» 
4 


Apvendix D 


¿execute command string. 


followed 


foiiowed 


: [BX] points to length, 


bv Command bvte, 
by zengin-1 raramecer 


153A. 89. 13.63 28 mov last com,BX ;save command address £ 
outer retry: 
¿allow some retrying 
2632 C6 06 62 28 OA mov rtry cnt,max retries 
retry: 
2663 BB 1E 63 28 mov BX,last com 
2667 E8 89 00 call send com -transmit command to i8 
; check status voll 
266A 88 ¡E 63 28 mov BX,last com 
256m 8A 47 01 mov al,1/íbx] :get command oo code 
2671 B9 00 08 mov cx,0800h «mask if it will be "in 
2674 3C 2C cmo al,?2ch 
2676 72 08 jb exec poll ¡OK if it is an intectu 
2678 B9 80 80 mov cx,3080h ¡else we use "not comma 
2673 24 OF and al,0fh 
2670 3C OC cmo al,Och :unless there isn't 
267F BO 00 mov al,0 
2681 77 36 ja exec exit : any result 
spoll for bits in CEH, 
exec poll: ; toggled with bits i^ 
2683 E4 AO in al,fdc,stat ¡read status 
2685 22 C5 and al,ch 
2687 32 Cl xor al,cl ; isolate what we want 
2689 74 F8 jz exec voll ;and looo until it is 4 
;Overation complete, 
268B E4 Al in al,fdc rslt ; see if result code in 
268D 24 LE and al,leh 
268F 74 28 jz exec exit sno error, then exit 
7 ; some type of error occ 
2691 3C 10 cmo al,10h 
2593 74 25 je dr, nrdy ¡was it a not ready dri 
¿no, 
dr rdy: ; then we just retry read or write 
2695 FE OF 62 28 dec rtry cnt 
2699 75 C8 znz retry : up to 10 times 
; retries do not recover from the 
: hard error 
2698 B4 00 mov ah,0 
269D 8B D8 mov bx,ax «make error code 16 bi* 
269F BB 9F 91 27 mov 5bx,errtbl1í8X] 
26A3 EB 45 FF call msg sorint aooropriate mess 
26A6 E4 DS in al,cdata :flush usart receiver > 
25A8 ES 2B FF call uconecho «read uücoer case consol 
26AB 3C 43 amo xl, c 
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26AD 
26AF 
26Bl 
26B3 
26B5 
2687 


26B9 


25BA 
26BD 
268F 
2502 
25C4 
26C7 


26CÀ 
2 6CD 
26CF 


26D1 
26D3 


26D4 


26D? 
26D9 
26DE 
26E0 


26E2 
26E5 


2628 
26EA 
25EC 
26EE 
26F0 
26F2 


74 
sc 
74 
3C 
74 
ac 


C3 


B6 
F6 
75 
B6 


BB 
E4 
A8 
EA 


84 
C3 


AS SE mo 


B3 


40 
06 


04 


TL 
OB 


AQ 
PA 


Al 
C6 


00 
00 


28 
EF 


00 


FE 


69 28 80 


28 
00 


Appendix D 


je wboot 1 ;cancel 

cmp al,'R* 

je outer retry  ;retry 10 more times 
cmp al,^I^ 


je z ret signore error 
or al,255 “set code for permanent 

exec exit: 

TU ret 

dr nrdy: «here to wait for drive ready 
call test ready 
jnz retry Sif it’s ready now we a 
call test ready 
jnz retry sif not ready twice in 


mov bx,offset nrdvmsg 
call omsg ;"Drive Not Ready" 


nrdyOl: 

call test ready 

32 NESVOL :now loop until drive r 

jmps retry ¿then go retry without 
zret: 

and al,0 

ret «return with no error c 
wboot 1: «cant make it w/ a sho 

jmo WBOOT 


¡RARA ARA ARA RARA RRA RARE RARA RARAS 
+ k 
f 


;* The 18271 requires a read status command * 
,* to reset a drive-not-ready after the a 
;* drive becomes ready * 
« * * 
t 

, REET ER ETRE ERR ERE REE RRA RARA RARA ARANA 


test_ready: 
mov dh, 40h soroper mask if dr 1 
test sel mask,80h 
jnz nrdyZ 
mov dh, O04h mask for dr 0 status t 

nrdv2: i 
mov bx,offset rds com 
call send com 

dr poll: 

d in al,fdc stat ¡get status word 

test al,80h 


jnz dr poll ‘wait for not command t 
in al,fdc rslt ¡get "special result” 

test al,dh “look at bit for this ^ 
ret return status of ready 


. CAER ode dede dede dede ode dede oe ie deo de ede oe eode e ee dede e de de e de de dne n ot 


.* A 
-* Send com sends a command and parameters * 
,* to the 18271: BX addresses parameters. * 


All Information Presented Here is Proprietary to Digital Research 


118 


BIOS Listing 


2553 
26F5 
26Fr7 


270A 
270€ 
2708 
2710 
2112 
2714 
2716 
2719 
2718 
271D 
211P 
2722 
2724 
2726 


2728 
272A 
2728 
272D 
£131 


24133 
2735 
4137 


2738 
273A 
£136 
273E 
2740 
2742 


07 
06 
AQ 


C9 
82 


AQ 
20 
FA 
07 
Al 
SE 


0l 


28 


28 


69 28 


- 
j 


* "The DMA controller i 
¿Y JE this is à read or 
S 

e dore deo ede node ode eode ceo ed de KEE 
send com: 

in al,fdc stat 
test ai,80h 


jnz send com 
¡see if we have 


mov al,líbx] 
cmp al,12h 

jne write mavbe 
Tov cl,40h 

j;nps init dma 


write maybe: 


emp al,0ah 
jne dma exit 
mov cl,80h 
init dma: 
;we have a read or write 


Appendix D 


3 also initialized * 
write * 
* 

jr de de oit rit cie ir ode cfe de ode ot og ode dr dr vn tn sde e 


;insure command not bus 
sloop until ready 


to initialize for a DMA 
;get command bvte 

or not a read it could 
;is a read command, go 
¿leave DMA alone if not 
¿we have write, not rea 


operation, setun DMA c 


n (CL contains prober direction bit) 


mov al,04h 
out dmac mode,al 
mov al,00 
out dmac cont,al 
mov al,cl 
out dmac cont,al 
mov ax,dma adr 
out dmac adr,al 
TOv al,ah 
out dmac adr,al 
mov ax,dma seg 
out fdc segment, 
mov al,ah 
out fdc seament, 
ama exit: 
mov cl,T2X] 
inc BX 
mov al,[BX] 
Or al,sel mask 
out fde com,al 
oarm loon: ~ 
dec cl i 
jz exec exit 
inc 3X 
carm coll: 
in al,fde stat 
test a1420H 
inz parm soll 
mov al,:8X] 
out fdc varm,al 
jmos oarm loop 


;enable ¿mac 
;send first bvte to 
“load direction regi 
¿send low byte cf DM 
¿send hich byte 
al ;send low bvte of se 
al ;then high secment a 
¿get count 
¿get command 


;merge command and driv 
;send command byte 


¿no (more) oarameters, 
,DOoint to (next) oarame 


¿test “parameter regist 
sidle until varm reg no 


¿send next oarameter 
:gO see if there are mo 


All Information Presented Here is Proprietary to Digital Research 


BIOS Listing 


2744 


2744 
2748 


276A 


2779 


2791 
2799 
27A1 


27A9 


2731 


0D 
20 
65 
65 
20 
20 
31 


0D 
20 
0D 
0D 
72 
54 
61 


Bl 
Bl 
CL 
EF 
02 
3D 
4D 
Bl 


OD 
20 
20 


2781 


48 
d 
00 
49 
15 
61 
74 


Bl 
Dl 
16 
Bl 
4E 


72 
3F 


6F 
72 


6E 
70 
70 
0D 
27 
27 
28 
27 
T9 


72 
00 


T3 
65 
31 
20 


6D 
6F 


74 
74 
20 
OA 
Bl 
DE 
28 
Bl 


6c 
6F 


74 
6E 
64 
one 
38 


65 
74 


65 
20 
48 
00 
27 
21 
28 
27 


6c 
po 


Appendix D 


.odeodeod deo dede dede oe ode oe de e ee de n de ee e de dede de de e de e de deci t e d de d den e 
* * 
* Data Areas - 
* * 

. dede de de decr dr he ode dee eode e de eo e e de e de de de d dee Pee e e de de n de ode e e n 


data offset equ offset $ 


dseg 
org data offset scontiguous wit 
LE loader bios 


% a ie EN ee ee cane dE A Ape m am ER NN ‘l -m m a Vm cm GE id n_n 


CULTO lt 
db ^CP/M-86 Version ne IAS, 


ENDIF ;loader bios 


I? not loader bios 


* <a ee ewe we ee "A Hu — — AA A m m m eh cm Ga HUP HER m im ee m d VER Cu qum cim Hs GE ac n a a m 


signon db GrILELOD LT 


db ^ System Generated - 11 Jan 8 
ral 

ENDIF ¿not loader bios 
bad hom db cr,1£,” Home Error’,cr,1f,90 


int_trp db cr,lf,’Interrupt Trap Halt”",cr, 


errtbl dw er0,erl,er2,er3 
dw er4,er5,er6,er? 
dw er8,er9,erA,erB 


dw erC,erD,erE,erP?P 
erO db cr,lLf, Null Error ??^,0 


eri equ erQ 
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27B1 
27B1 


ZTC 


21D 


27DE 


2802 


" 2816 


2828 


283D 


284D 


OD 
6B 
72 
OD 
20 
00 
0D 
52 
6F 
0D 
20 
T4 
00 
0D 
65 
52 
3A 
OD 
65 
65 
0D 
30 
20 
20 
0D 
65 
74 
0D 
6F 
20 
20 


2781 
2781 
27B1 
2802 


2862 
2863 
2865 
2867 
2869 


286A 
2868 
286C 
286D 


286E 
2871 


OA 
20 
20 
0A 
44 


OA 


72 
0A 
43 
T2 


0A 
20 
65 
00 
0A 
20 
63 
OA 
30 
46 


OA 
20 
20 
OA 
72 
46 
3A 


00 
00 
00 


29 
2C 


43 
45 
3A 
4c 
4D 


49 
20 
20 
44 
52 
GF 


44 
61 


57 
50 
74 
54 
20 
6r 
00 
57 
46 
3A 
53 
20 
6F 
00 


00 


74 
74 
64 


er2 equ 
eri equ 
erá db 
er5 db 
eró de 
er? db 
erB db 
er9 db 
erA db 
ers db 
erc db 
erD equ 
erE equ 
erF equ 
nrdymsg equ 


rtry cnt db 
last com dw 


dma adr 
dma seg 


dw 
dw 


sel mask db 


+ 
t 


Appendix D 


ero 
erg . 
erf; Clock Error :',0 


er,lf,° Late DMA :^,0 


cr,lf,"ID CRC Error :°,0 


cr,lf,^Data CRC Error :°,0 


er,lf,°Drive Not Ready :“,0 


cr,1f, “Write Protect :”,0 


cr,lf,/Trk 00 Not Found :°,0 


cr,1f£, "Write Fault :',0 


cr,lf,^Sector Not Found :~,0 


erg 
erQ 


0 ¿disk error retry counter 

0 .address of last command string 
0 sdma offset stored here 

0 :dma segment stored here 

40h ;select mask, 40h or 80h 


Various command strings for i8271 


io com db 


rd wr 


trk 


sect 


db 
db 
db 


hom_com db 
rds com db 


. 
, 


3 : length 

0 :read/write function code 

0 «track $ 

0 «sector 4 

2,295 ,0 «home drive command 


l ¿cn «read status command 


System Memory Segment Table 
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àORON NON WÉüN NON VON HON un... (.1..00.0..0:::0 WO 39 UN HU UN ORO NOW 83 NN V OU WOW NM ON M 


2913 
2874 
2876 
2878 
287A 


287C 


2076 
2880 
2884 
2888 
288C 
2890 
2894 
2898 


00 
cS 


64 


00 
C5 
23 


289C 


289C 
289E 
289F 
28A0 
28A1 
23A3 
28A5 
28A6 
28A7 
2849 


28AB 


28AB 
28AF 
28B3 
2887 
2888 
29BF 
28C3 


001 


0010 


299€ 
001P 
0010 
28AB 


2903 


28C5 
2945 
2964 
2974 
2993 


28 
00 
28 
29 
28 
00 
28 
29 


00 


00 
00 


00 
00 
28 
29 
00 
90 
28 
29 


segtable db 2 


dpbase 
dpe 


¿vel 


dpbO 


alsO 
css 


dobl 

lsl 
cssl 
“Le. 


* 
, 


, 
oeqdat 
dirbuf 
alvo 
esvQ 
al-i 
esvl 


:2 segments 


dw toa sed :lst seq starts after B 

dw tva len ;and extends to 08000 

dw 2000h «second is 20000 - 

dw 2000h ;AJFFFF (128k) 

include singles.lib ;read in disk defin 
DISKS 2 

equ S :Base of Disk P 

dw x1t0,0000h ;Translate "Tabl 

dw 0000n,0000h ¿Scratch Area 

dw dirbuf,dpbo sDir Buff, Parm 

dw csv0,alv0 «Check, Alloc Y 

dw xltl1,0000h ‚Translate Tabl 

dw 0000n,0000h ¡Scratch Area 

dw dirbuf,dobl «Dir Buff, Parm 

dw csvl,alvl ;Check, Alloc V 
DISKDEF 0,1,26,6,1024,243,64,64 

equ offset S :Disk Parameter 

dw 26 ¡Sectors Per Tr 

áb 3 ¿Block Shift 

db 7 Block Mask 

ab 0 ;Extnt Mask 

dw 242 «Disk Size - l 

dw 63 ¿Directory Max 

do 192 ;AllocO 

db 0 ;Allocl 

dw 16 «Check Size 

dw Z ;:Offset 

equ offset $ ;"ranslate Tabl 

db IES 

db 25,511,211 

db 23.35,9,15 

db 214,2,8;,14 

db 20, 26507 12 

db 18,24,4,10 

db 16,22 

equ 31 ;Allocation Vec 

equ 16 ¿Check Vector S 
DISKDEF 1,0 

edu pbo «Equivalent Par 

equ also :Same Allocatic 

equ css0 ¿Same Checksum 

equ x1t0 «Same Translate 
ENDEF 


Uninitialized Scratch Memorv Follows: 


equ 


rs 
rs 
rs 
rs 
ES 


«Start of Scrat 


offset S 

128 «Directory Buff 
alsd :Alloc Vector 

css0 «Check Vector 
lst -Alloc Vector 

cssl «Check Vectot 
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= 29A3 
= 00DE 
= 29A3 00 


29A4 
29E4 
29E4 
02DF 


0521 
29E4 00 


0000 


0000 
0002 


0004 


0380 
0382 


enddat 
datsiz 


loc stk 
stkbase 


lastoff 
tpa seg 
tpa len 
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equ offset S sEnd of Scratch 
equ offset S-begdat ;Size of Scratc 
db 0 ¿Marks End of M 


rw 32 ¿local stack for initialization 
ecu offset S 

equ offset S 

equ (lastoff£+0400h+13) / 16 

equ 0800h - tba seg 

db 0 ;fill last address for GENCMD 


s de deofe cde cde de ode deiode idee ode ode oe eode ode e de dee oe ode ode ode o ode de eoe fee ode oe eoe de de de dr d dee o X 


.* 
t 


>*t 
t 


. Y 
4 


* 


Dummy Data Section ` 
* 


; eode eie de e e de eoe e decide de dece re e de eee e ede de de fe de de de e dr de de d d d m ele e 


dseg 0 ¡absolute low memory 
org 0 : (interrupt vectors) 
int0 offset rw i 
intO segment rw 1 
: pad to system call vectoc 
rW 2*(bdos int-1) 
odos offset rw 1 
bdos_segment rw i 
END 
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APPENDIX E:  CBIOS LISTING 


gd ded eode ed ded de de de de dede de d de de e e dede de de ede dede edo RARA RANA 


* 

* This is the listing of the skeletal CBIOS which 
* you can use as the basis for a customized BIOS 
* for non-standard hardware. The essential por- 
* tions of the BIOS remain, with "rs" statements 
* marking the routines to De inserted. 

* 
* 


4 + uo + +t H 


deiode de de eode dede ee ode e de de t deo de dee mode e e AA de de dede de dede deo deem 


* 


Re RRR dede ode eoe cie de fe dede eode ode ee de e de e e dede de Hee e ic de de t o n d A 


This Customized BIOS adapts CP/M-86 to 
the following hardware configuration : 
Processor: 
Brand: 
Controller: 


„s; 9 ^e oe "9 “8 


Programmer: 


* 
rr 
$ 
* 
* 
* 
» 
* 
* 

Revisions : 2 
* 
* 


* * © + 0 X o Xx & OX 


~s $” =p "a4 -u 


dete dede ce oe dede dede dede de eode de RARA de e de de de ie de eode m de de de een e 


FFFY true equ -1 

0000 false equ not true 

000D Er equ Odh ;carriage return 
000A lf equ Oah ;line feed 


EER AEE ERE AAA ie de de ee ede cde ie e de e de e de e de de de eoe e d e 


.* * 
;* Loader bios is true if assembling the a 
.* LOADER BIOS, otherwise BIOS is for the : 
;* CPM,SYS file. * 
e * * 
QRRRERttRERERTETRRETUR EE E RARE AE iere 
0000 loader bios equ false 
QOEO bdos int equ 224 ;reserved BDOS interrup 
IF not loader bios 
: | | 
2500 bios code equ 2500h 
0000 cep offset equ 0000h 
9806 bdos ofst equ 0B06h ;BDOS entry point 
sho 
ENDIF snot loader bios 
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CBIOS Listinq 


2500 
2503 
2506 
2509 
250C 
250F 
2512 
2515 
2518 
251B 
251E 
2521 
2524 
2527 
252A 
252D 
2530 
2533 
2536 
2539 
253€ 


253P 
2541 
2543 


E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 
E9 


8C 
8E 
8E 


3c 
79 
85 
8D 
9A 
A2 
BS 
BD 
F6 
D9 
01 
03 
oc 
17 
47 
8r 
F9 
02 
04 
A4 
A5 


cs 
DO 
D8 


00 
00 
00 
00 
00 
00 
00 
00 
00 
00 
01 
01 


01 
01 


00 
01 
01 
00 
00 


IF 
: | 
bios code 
ccp offset 
bdos ofst 
of 7 
ENDIP 
eseg 
org 
cep: 
org 


Appendix E 


loader bios 


* -— uu END E QUE O GER ee GENE INE GENERO NEED A GER Gum À duse TR do di comb dass -— dele e E mc E GN UE oe ndn I 


equ 1200h ;start of LDBIOS 
equ 0003h ;base of CPMLOADER 
equ 0406h :strioced 3DOS entry 


;loader bios 


ccpoffset 


bios code 


s de e fe e de de le de dece de se ide de ode dee eode decode ode oe oie de dee oe fn ode dr cie eoe de de e dr e de e o de n x 


* 


=e =e ms 9 


* 


* 


* BIOS Jump Vector for Individual Routines * 


* 


e eoe se dese eode dede de de oie ode oe ie de de ose eode e she oe e ode de de si e oe ode de e dede deridet de m d rr o 


~ 


jmp 
jmp 
Jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmp 
jmo 
jmp 
jmp 
jmp 


* 
t 
p 
t 
, 


INIT 
WBOOT 
CONST 
CONIN 
CONOUT 
LISTOUT 
PUNCH 
READER 
HOME 
SELDSK 
SETTRK 
SETSEC 
SETDMA 
READ 
WRITE 
LISTST 
SECTRAN 
SETDMAB 
GETSEGT 
GETIOBF 
SETIOBF 


de de e de ode cde dede de fe de ie de e eir de de ede dese ede e de de fee ode eode it e de de dede ye dede n dn tg 
* 


sEnter from BOOT ROM or LOADER 
sArcrive here from BDOS call 0 
«return console kevboard status 
¿return console keyboard char 
write char to console device 
«write character to list device 
write character to bunch devic 
return char from reader device 
move to trk 00 on cur sel driv 
select disk for next cd/write 
eset track for next rd/write 
¿set sector for next rd/write 
«set offset for user buff (DMA) 
«read a 129 byte sector 

¡write a 128 bvte sector 
«return list status 

:Xlate logical->ohysical sector 
¿Set seg base for buff (DMA) 
'return offset of Mem Desc Tabl 
return I/O mao byte (IOBYTE) 
:set I/O map byte (IORYTE) 


;* INIT Entry Point, Differs for LDBIOS and * 


:* BIOS, according to "Loader Bios" value la 


.* 
t 


+ 


» fe *e de e de de de de de de e de eode de de de dede e e e de 1111111111554 deo 
+ 


INIT: 


:orint signon message and initialize ha 


mov aàax,cs 


swe entered with a JMPF 


mov ss,ax ;CS: as the initial val 
mov ds,ax :DS:, 
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2545 


2547 
254A 


2548 
254C 
2394 
2554 
2556 


2558 
255E 
2562 
2565 
2568 
256B 


256D 
2513 


2574 
2577 
257A 
257C 


2257F 


SE 


co 


BC -59 28 


EG 


BB 
ES 
81 
E9 


EJ 


06 


D8 
Co 


06 
OE 
04 
00 
FE 
AS 


06 


Bl 


^7 
00 


00 
02 
00 
00 
01 


80 


26 


6F 00 


00 


8l DA 


84 DA 


26 00 


00 82 25 


00 


03 06 


0B 


^ mm — A— u a oe 


WBOOT: 


Appendix E 


mov es,ax ;and ES: 

suse local stack during initialization 
mov sp,offset stkbase 

cid «set forward direction 


LE not loader_bios 


> This is a BIOS for the CPM.SYS file. 
: Setup all interrupt vectors in low 
; memory to address trab 


push ds “save the DS register 
mov IOBYTE,O : Clear IOBYTE 

mov ax,0 

mov ds,ax 

mov es,ax «set ES and DS to zero 
¿setup interrupt 0 to address trap rout 
mov int0 offset,offset int trap 

mov intO segment,Cs 

mov di,4 

mov si,0 ;then propagate 

mov cx,510 ‘trap vector to 

reo movs ax,ax ¡all 256 interruocts 
:BDOS offset to oroper interrupt 

mov bdos offset,bdos ofst 

pop ds ` «restore the DS registe 


(additional CP/M-86 initialization) 


ENDIF snot loader bios 


IF loader bios 


«This is a BIOS for the LOADER 

push ds :Save data segment 

mov ax,0 

mov ds,ax ¿point to segment zero 
:BDOS interrupt offset 

mov bdos offset,b5dos ofst 

mov bdos segment,CS ;bdos interrupt seg 
(additional LOADER initialization) 

cop ds ;restore data segment 


ENDIF ;loader bios 


mov bx,offset signon 


call msg ¿orint signon message 
mov cl,0 «default to dr A: on co 
imp ccp ¡jump to cold start ent 


jmo cc2*6 «direct entry to CCP at 
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2582 
2393 
2585 
2387 
233A 
258D 


258E 
2598 


2599 
2290 
259E 
25A8 


2549 
2583 


25B4 
25BE 


25BF 
25C9 


25CA 
25D4 


25D5 
25DF 


25E0 
2223 


PA 
8c 
8E 
BB 
ES 
F4 


ES 


EB 


74 } 


C3 


C3 


C3 


C3 


Ca 


sk 


AQ 
63 


CB 


Dl 26 
5C 00 


A7 26 


pee —— ami — adm a pu apum ndm dA E 


E 
ine trap: 

y cli 
mov 
mov 
mov 
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not loader bios 


mulas dlls e EHE WERE RR UND UN NP O m xum ee m m m m e A A A UA A UT CEPS O A NDS O NA Ca mmo GE I 


¿block interrupts 
ax,cs 
ds ,ax :get our data segment 
bx,offset int tro 


call pmsg 


ELE 


% - udo EP md E END CAP ee ee m 


;hardstoo 


ENDIF ¡not loader bios 


« fe st cr se cie ode ede ode eode e de de ose e decode dee de ode oie eoe ce eoe ee ie ode dede codeine eon eor de on d 
+ 


.P* 
r 


. * 
t 


* 


;* CP/M Character I/O Interface Routines * 
t 


e fe he cie e de de de e de de ode oe oe EA fede cde ode ode AAA oe oe ole de REE RSA RAR RRR EOE 
" 


CONST: “console status 
rs 10 .{fill-in) 
ret 
CONIN: «console input 
call CONST 
jz CONIN ¿wait for RDA 
rs 10 (fill-in) 
ret 
CONOUT: ¿console output 
rs 10 |[fillelnm) 
ret «then return data 
LISTOUT: sList device output 
rs 10 :(fill-in) 
ret 
LISTST: ;ocll list status 
rs 10 ; (fill-in) 
ret 
PUNCH: ¡write ounch device 
rs 10 ;(fill-inm) 
ret 
READER: 
rs 10 «(fíll-in) 
ret 
GETIOBF: 
mov al,IOBYTE 
ret 
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CBIOS Listing 


25E4 88 OE A7 26 


25E8 


4959 
25EB 
25ED 
25EF 
2oF1 
25F4 
Zr 


C3 


8A 
84 
74 
3A 
ES 
43 
EB 


0002 


25F7 
25FB 
25FE 
2601 
2603 
2605 
2607 
2609 
260B 
260E 
2610 


2611 
2511 
2621 


2622 
2626 


2627 
2628 


2026 
2625 
2630 
2632 


2633 
2637 


88 
8B 
80 
T3 
B5 


cl 


C3 


89 
C3 


39 
Ga 


8B 
03 
8A 
d 


39 
Ea 


07 
CO 
21 
C8 
85 


Fé 


QE 


F9 
0D 
00 
D9 
04 
ES 
El 
D9 


06 


OE 


D9 
DA 


LE 


AB 


02 


26 


A9 


A9 


26 


26 00 00 


26 


26 


QE AD 26 


Apoendix E 


SETIOBF: 
mov IOBYTE,cl «set iobyte 
ret ;iobyte not implemented 


pmsg: | 
mov al,[BX] ;det next char from mes 


test al,al 


jz return :if zero return 

mov CL,AL 

call CONOUT orint it 

inc 8X 

jmps msg ¿next character and loo 


» ft ie sie ce de ode oe de oe cie dnos sien de deiode iode dede decode ode ode cir dn DAA DARA ADA oe oie e cien dein 


Ul 

« * * 
d Disk Input/Output Routines * 
» Y * 


e eof AEREA e ede de ode ode ode ode eode nde ode de ode ode ode AAA AAA oie ode oe ode code iode ede eode de on dn t x 


SELDSKEK: ¿select disk given bv register 
ndisks equ 2 ;number of disks (up to 16) 
mov disk,cl «save disk number 
mov bx,0000h ;ready for error return 
cmp cl,ndisks ;n beyond max disks? 
jnb return ¡return if so 
mov ch,0 : double (n) 
mov bx,cx ¡Ox - n 
mov cl,4 ¡ready for *16 
shl bx,ci A = qp L8 
mov cx,offset dobase 
add bx,cx ; debase + n * 16 
return: ret ¿bx = .doh 
HOME: «move selected disk to home position [T 
mov trk,0 ¿set disk i/o to track 
rs 10 ;(E£ill-in) 
ret 


SETTRK: ;set track address given by CX 
mov trk,CX 
ret 


SETSEC: ¿set sector number diven bv cx 
mov sect,CX 
ret 


SECTRAN: ;translate sector CX using table at [D 
mov DX,cx 


add bx,dx «add sector to tran tab 
mov bl, {bx] :qet logical sector 
ret 


SETDMA: ¡set DMA offset given bv CX 
mov cma adr,CX 
ret 
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CBIOS Listing 


2638 89 OE AF 26 
2630 C3 
. 263D BB E8 26 
2640 C3 
4 
2641 
2673 C3 
2614 
26A6 C3 
i 
26A7 
26A7 00 
26A8 00 
26A9 00 00 
26AB 00 00 
26AD 00 00 
26AF 00 00 


Apoendix E 


SETDMAB: ¿set DMA segment given by CX 
mov dma seg,CX 
ret 


GETSEGT: ¡return address of ohvsical memory ta 
mov bx,offset seg table 
ret 


, dede de dede dede ed e dede deo e dde e dod doo dew 


* 

All disk I/O parameters are setub: * 
DISK is disk number (SELDSK) * 
TRK is track number (SETTRE) * 
SECT is sector number (SETSEC) * 


DMA ADR is the DMA offset (SETDMA) * 
DMA SEG is the DMA secment  (SETDMAB)* 
READ reads the selected sector to the DMA* 
address, and WRITE writes the data from * 
the DMA address to the selected sector e 
(return 00 if successful, 01 if perm err)* 
* 


de hr eode de de eode ode ode ede ode de de deiode de ode ode oe dede eoe cde cde oie coe ode dee ede dede de dn on 


mp *".» ng ne C.» "ot "=p "th "o “a c8 =p "e 
eet + Y + € Y y e 4 8 Y 


READ: 
rs 50 FEL LiMn 
ret 

WRITE: 
rs 50 (fill-in) 
ret 


Ck de de e e de de e e e de e e de e e de e de eR ee de ede e eed o e n 


»ode fe eode decode de ode de dede de e de eode e oe oe ode ode ode eoe e ode oe oe dede de ode cie ede e eode de ode o nn 


Q* * 
pr Data Areas * 
e* * 


data offset equ offset S 

dseg 

org data offset ¿contiguous wit 
IOBYTE db 0 
disk ab 0 «Fisk number 
trk dw 0 «track number 
sect dw 0 ¿sector number 
dma_adr dw 0 ;DMA offset from DS 
dma seg dw 0 ;DMA Base Segment 

IF loader 5ios 
ooo | 
signon db CELE 


db ^CP/M-B6 Version 1.0^,cr,1f,0 
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2681 
26B5 


26CE 


26D1 
26D3 


26E6 


2658 
2689 
26EB 
26ED 
26EF 


0D 
23 
20 


30 
30 
0D 


0D 
49 
75 
61 


0D 


02 
C6 
3A 


00 


26Fl 


26F1 
26F5 
26F9 
26FD 
2701 
2705 
2709 
270D 


20 
00 
3A 
D9 
20 
00 
3A 
08 


2711 


2711 
2713 
2714 
ZO 
2716 
2718 
271A 
2713 
LS 
ar LE 


10 
02 


QA 
79 
47 
74 
¿Y 


OA 


0A 
6E 
70 
70 


0A 


02 
05 
20 
20 


27 
00 
27 
27 
27 
00 
27 
28 


00 


00 
00 


00 
00 


OD 
13 
65 
30 


00 


74 


20 


0A 
74 
6E 
64 
30 


65 
20 
48 


00 
00 
27 


00 
00 
e 
27 


65 
65 
20 


¿F 


12 


61 


5D 
72 
30 
30 


72 
72 
eC 


Appendix E 


e un um ——--— qum cue qu e cá m ds eee e m s dm abdo O UND SSS SOS SP Fee cmm OS Se BeBe Ss Seat = = 


;loader Dios 


not Loader bios 


+ a- —— — b sie cm ee AU a A EP m UNA dE D GARE ARP NR AREA A AA AUR. GENS mms d am m ca e e ee eee um uum dA a cuum O A AN mm 


signon 


" 
, 


Segtable db 2 
dw tpa seg 
dw toa len 


db 


Pele sot pee 

“System Generated 00/00/00” 
wi E 

;not loader bios 


ET E 
“Interrupt Trap Halt” 


or Lt 


System Memorv Segment Table 


;2 segments 
-lst Seq starts after B 
:and extends to 08000 


dw 2000h ;second is 20000 - 

dw 2000h :3FFFF (128k) 

include singles.lib ;read in disk Zefin 
; DISKS 2 
dobase equ S «Base of Disk P 
doed dw xit0,0000h «Translate Tabl 
dw 0000h,0000h ¿Scratch Area 

dw dirbuf,dobO ¿Dir Buff, Parm 

dw csvO,alvO «Check, Alloc V 
doel dw x1t1,0000h «Translate Tabl 

dw 0000h,0000h ¿Scratch Area 

dw dirbuf,dob. «Dir Buff, Parm 

dw esvl,alvl «Check, Alloc V 
; DISKDEF 0,1,26,5,1024,243,54,54 
dob0 equ offset S :Disk Parameter 
dw 26 Sectors Per Tr 

db 3 “Block Shift 

db 7 «3lock Mask 

db 0 ;Extnt Mask 

dw 242 "Disk Size - 1 

dw 63 ¿Directory Max 

db 192 :AllocO 

db 0 ;Allocl 

aw 16 ¿Check Size 

dw 2 :Of f£set 
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2720 


2720 
2724 
2728 
272C 
2730 
2734 
2738 


01 
19 
Ly 
15 
14 
L2 
10 


001P 
0010 


2111 
001F 
0010 
2720 


273A 


273A 
27BA 
27D9 
2189 
2908 


2818 
DODE 


2818 


2819 


00 


2859 


2859 
02C6 
053A 
2859 00 


0000 


0000 
0002 


0004 


0380 
0382 


05 
03 
02 


18 
16 


OD 
OB 
09 
08 
06 
04 


L3 
LI 
OF 
JE 
oc 
OA 
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x1t0 edu offset S ¡Translate Tabl 

db L,7T,.13,19 

db > ho ee grip a ee Oe 

db 2334975 

db 21,42,98,14 

db 40,45,60,12 

db 18,24,4,10 

db 15522 
alsO equ 34 ;Allocation Vee 
ess0 equ 16 ¿Check Vector S 
; OISKDEF 1,0 
dpbl equ dpbO ,Equivalent Par 
alsl equ also "Same Allocatio 
cssl equ cssÓ :Same Checksum 
xltl equ xltO :Same Translate 
; ENDEF 
; Uninitialized Scratch Memorv Follows: 
begdat equ offset $ ¿Start of Scrat 
dirbuf rs 128 Directory Buff 
alvo rs alsO ;Alloc Vector 
csvO rs ess0 ¿Check Vector 
alvl rs alsl ;Alloc Vector 
csvl rs cssl «Check Vector 
enddat equ offset S :End of Scratch 


datsiz equ 
db 


loc stk rw 
stkbase equ 


lastoff equ 
tpa seg equ 
tpa len equ 

db 0 


sTRERCERRARA NR 
» Y 
' 

. t 

t 
.* 
f 


offset $-begdat ;Size of Scratc 
0 | «Marks End of M 


32 ¡local stack for initialization 
off$et S 


offset S 
(lastoff£+0400hn+15) / 16 
0800h - tpa seq 
:fill last address for GENCMD 


HEAAREAFRERECA RE RARA RARE RRA 
t 


Dummy Data Section e 
* 


« defe de de de de de se de de se de he fe de de de de ode eoe ose ode ce ode die eoe ode ode o od don nde deo o om dn den 


f 


dseg 


org 
intO offset 


intO segment 


; pad 
tw 


bdos offset 


odos segment 


END 


0 ¡absolute low memory 
0 :(interrupt vectors) 
rw L 
rw 1 


to system call vector 
2*(bdos int-1) 


rw L 
rw jd 
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APPENDIX P: BLOCKING AND DEBLOCKING ALGORITHMS 


de de dese RARER RARER cc dr eode ode de ode ode oder oe ode ode de ode eode eode eode ode eon ir eet 


Sector Blocking / Deblocking 


- "e es "9 we 


+ y * + + 4 4 + +» 


+ 
* 
* 
This algorithm is a direct translation of the * 
CP/M-80 Version, and is included here for refer- * 
ence purposes only. The file DEBLOCK.LIB is in- * 
t 
* 
* 
* 
* 


cluded on vour CP/M-86 disk, and should be used 
tor actual apolications. You mav wish to contact 


* Digital Research for notices of updates. 
* 


== +a q. 98 “ua 


EAE ES AS SOLAS EP SE Se ee 


de de dede he cir dee de ode oe ode ode in dede dece e e SER RSE RE SERPS ERE ERR RRR RRR ARO e e e 


CP/M to host disk constants 


* + + + 


(This example is setup for CP/M block size of 16K 
:* with a host sector size of 512 bytes, and 12 sec- 
;* tors per track. Blksiz, hstsiz, hstsot, hstbik 

:* and secshf may change for different harcware.) 
 RERERE TE RERE RHR ERE ERE ERRHEREREREHERREEERUREERTEN EES 


una equ byte ptr [BX) ;name for bvte at BX 

blksiz equ 16384 :CP/M allocation size 
nstsiz equ 512 ¡host disk sector size 
hstsot equ 12 ¿host disk sectors/trk 
hstblk equ hstsi2/128 ;CP/M sects/host buff 


» 
' 
y ted ded dde RERGEREHEROUR EPOR CIERRE HEIC ERATE SHEER EAE NE OS 


. t 
F 


:* secshf is log2(hstblk), and is listed below for 


^* values of hstsiz uo to 2048. 


=. 35 
+ 


Li 
* 
d 
* 
de hstsiz hstblk secshf ^ 
de 256 2 l si 
* 
* 
* 
* 
* 


* © © + $ o + 


SL 4 2 
1024 8 3 
2048 15 4 


* * © 


F 
. 
, 
a 
t 
. 
+ 


.* 
t 


QR P dede Ro eo de dece de ede e Ro de e eode dee de de e We dide e e e e oon dede er d e d 


secshf equ 2 slog2{hst51) 
cpmspt equ hstblk * hstsot ;CP/M sectors/track 
secmsk equ hstblk-l «sector mask 


, 
eee EEE TERRE RARA AEREA AAA ARA 


.* * 
LI 


;* BDOS constants on entry to write * 


. * * 
t 


, dede eedem AA REA de de de eee eo Ro o do do d oo ARETE SES 
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Blocking and Deblocking Algorithms 

51: wrall equ Q ¿write to allocated 
52: wrdir equ l swrite to directory 
33: wrual equ 2 ¡write to unallocated 
54: : 

55: y dede dede dece ode dee de dno de dee ede o de ede dede ie et e m mm 
56: 2% ¥ 
A The BIOS entry voints given below show the * 
294 q" code which is relevant to deblocking oniv. * 
= . . * * 
a. ORAR ARANA ARA RRA RARA RRA RARA RARA RARA AAA 
6l: seldsk: 

62: «select disk 

63: «is this the first activation of the drive? 
64: test DL,l sisb = 0? 

631 jnz selset 

66: this is the first activation, clear host buff 

T: mov hstact,0 

68: mov unacnt,0 

69: selset: 

70: mov al,cl ! cow ;Dut in AX 

Tl mov sekdsk,al «seek disk number 

TX mov cl,4 ! shl al,cl ¿times 16 

ps add ax,offset dpbase 

74: mov bx,ax 

TES ret 

763 ; 

77: home: 

78: :home the selected disk 

79: mov al,hstwrt ;check for oending write 
80: test al,al 

81: jnz homed 

82: mov hstact,0 sclear nost active flag 
B3: homed: 

84: mov cx,0 “now, Set track zero 
Bor + (continue HOME routine) 

86: ret 

87: 3 

88: settrk: 

89: :set track aiven by registers CX 

90: mov sektrk,CX "track to seek 

91: ret 

92: > 

93: setsec: 

94: ¿set sector given bv register cl 

95: mov seksec,cl «sector to seek 

96: ret 

97: ; 

98: setdma: 

99: ;set dma address given bv CX 
100: mov dma off,CX 
101: ret n 

102: : 
103: setdmab: 
104 «set segment address given Sy CX 
105: mov dma_seg,Cx 
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106: ret 

107: ; 

108: sectran: 

109: «translate sector number CX with table at [DX] 
110: test DX,DX «test for hard skewed 

Lille jz notran : (blocked must be hard skewed) 
rEZ: mov BX,CX 

113: add BX,DX 

114: mov BL, [BX] 

LLS: ret 

116: no tran: 

117: shard skewed disk, ohysical = logical sector 
118: mov 3X,CX 

119: ret 

L20: E 

121: read: 

122: ;read the selected CP/M sector 

Laos mov unacnt,0 «Clear unallocated counter 
ee mov readoo,l ;read operation 

L252 mov rsflagy»l ¿must read data 

126: mov wrtype,wrual ¡treat as unalloc 
Lil: jmo rwoper - sto perform the read 
L285-3 EIN 

129: write: 

130% write the selected CP/M sector 

LaL: mov readoo,0 «write overation 
LIZ: mov wrtvpe,cl 

133: cnp cl,wrual ¡write unallocated? 
134: jnz chkuna “check for unalloc 
135: ; 

L36: 3 write to unallocated, set Daramecters 

137: 3 

138: mov unacnt,(5lksiz/128) ¿next unalloc recs 
139: mov al,sekdsk :disk to seek 

140: mov unadsk,al «unadsk s sekdsk 
141: mov ax,sektrk 

142: mov unatrk,ax :unatrk = sektrk 
143: . mov al,seksec 

144: mov unasec,al 'unasec s seksec 
145: ; 

146: chkuna: 

147: «check for write to unallocated sector 

148: ; 

149: mov 5bx,oftset unacnt «Doint "UNA" at UNACNT 
150: mov al,una ! test al,al :anv unalloc remain? 
151: 5z alloc ¿skip if not 

152: ; 

1333 5 more unallocated records remain 

154: dec al :unacnt s unacnt-1 
155: mov una,al 

156: mov al,sekdsk ¿same disk? 

157: mov BX,offset unadsk 

158: emp al,una ;sekdsk = unadsk? 
159: jnz alloc ;Skio if not 

160: : 
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1515 3 disks are the same 

1527 mov AX, unatrk 

163: emp AX, sektrk 

164: jnz alloc ¿skip if not 

165: ; 

165: + tracks are the same 

167: mov al,sexsec ¿same sector? 

168: ; | 

1 mov BX,offset unasec :ooint una at unasec 
INL: cmp al,una ;seksec = unasec? 

Lie jnz alloc sskio if not 

173: 3 

174: 3 match, move to next sector for future ref 

175: inc una sunasec = unasec*l 
176: mov al,una send of track? 

Lats cmp al,comsot Count CP/M sectors 
1783 ib noovf «skip if below 

179: = 

180: ; overflow to next track 

181: mov una,92 :unasec = 0 

182: inc unatrk :unatrksunatrk-^l 

183: + 

184: noovf: 

185: «match found, mark as unnecessary read 

186: mov rsflag,O0 «rsflag = 0 

1B7* jmps rwoper sto oerform the write 
188: ; 

189: alloc: 

190: snot an unallocated record, requires pre-read 
191: mov unacnt,O -unacnt = 0 

192: mov rsflag,l ;rsflag = 1 

193: sdrop through to rwover 
194: ; 

195: SEGURA AREE EEE EE EEEE CARA ODE AGO ROGA EES 
196: ;* > 
L97: O Common code for READ and WRITE follows * 
198: ;* i 


201: senter here to perform the read/write 

202: mov erflad,0 sno errors (yet) 
203: mov al, seksec scompute host sector 
204: mov cl, secshf 

205: shr al,cl 

206: mov sekhst,al “host sector to seek 
207% 4 

208: ; active. host sector? 

209: mov al, il 

210: xchg ai,hstact ;alwavs becomes 1 
21l: test al,al «was it alreadv? 
212: jz filhst ;fill host if not 
2l31 

4145 3 host buffer active, same as seek buffer? 
215: mov al,sekdsk 
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216: 
217: 
218: 
219: 
220: 
221: 
222: 
Ted; 
224: 
225: 
226: 
227% 
228: 
229: 
230: 
23l: 
132: 
2337 
234: 
239% 
236: 
2315 
239: 
239: 
240: 
241: 
242: 
243: 
244: 
245: 
246: 
247: 
248: 
249: 
450: 
251: 
252: 
253: 
254: 
255: 
256: 
257: 
258: 
259: 
260: 
261l: 
262: 
263: 
264: 
265: 
266; 
267: 
268: 
269: 
270: 


All 


nomatch: 


mo ~u 
ya 


ilhst: 


rh se 


ilhstl: 


match: 


cmp al,hstdsk 
jnz nomatch 


same disk, 
mov ax,hsttrk 
emp ax,sektrk 
jnz nomatch 


same disk, 
mov al,sekhst 
emp al,hstsec 
j2 matc! 


«prover disk, 
mov al, 
test al,al 
12 filhst 
call writehst 
(check errors 


same track, 


hstwrt 


Appendix F 


*Sek2sk = Kstdsk? 


Same track? 


shost track same as seek track 


same buffer? 


*sekhst = hstsec? 
¿skip if match 


but not correct sector 
buffer ? 


don’t need to write 
clear host buff 


"EIPEVO 

¿no, 

¡Yesxs, 
here) 


¿may have to fill the host buffer 


mov al,sekdsk 
mov ax,sektrk 
mov al,sekhst 
mov al,rsflag 
test al,al 
32 frilhstl 


call readhst 
(check errors 


mov hstwrt,O 


¿Copy data to 
mov al,seksec 
and ax,secmsk 
mov cl, 7 ! 


shl ax,cl 


! mov hstdsk,al 
! mov hsttrk,ax 
t mov hstsec,al 


«need to read? 


«ves, if 1 


here) 


¿no vending write 


or from buffer depending on "readoo" 
¿mask buffer number 

“least signif bits are masked 
¿Shift left 7 (* 128 = 2847] 


ax has relative host buffer offset 


add ax,offset 
mov si,ax 


mov di,dma off 


oush DS ! 


mov ES,dma seg 


mov cx,128/2 
mov al,readoo 
test ai,al 


push ES 


hstbuf «ax has buffer address 
«put in source index register 


user buffer is dest if readooc 
«save segment registers 

Set destseg to the users seg 
:SI/DI and DS/ES is swapped 
if write OD 

«length of move in words 


ewhich wav? 
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All? 
272: 
273: 
274: 
2195 
276: 
cite 
278: 
279: 
280: 
281: 
2022 
2834 
284: 
285: 
286: 
287: 
4988: 
289: 
290: 
291: 
292: 
293: 
294: 
2993 
296: 
297: 
298: 
299: 
300: 
301: 
302: 
303: 
304: 
305: 
306: 
307: 
308: 
309: 
310: 
ALIS 
314 
2114 
314: 
315: 
316: 
317: 
318: 
319: 
320: 
321: 
322: 
1232 
324: 
328: 


All 


=e =s 


* 


jnz rwmove eskio if read 

write operation, mark and switch direction 

mov hstwrt,l «hstwrt s 1 (dirty buffer now) 
xchg si,di «source/dest index swap 

mov ax,DS 

mov ES,ax 


mov DS,dma seg ;setuo DS,ES for write 
; 
rwImcve: 

cld ! rep movs AX,AX move as 16 bit words 

coo ES ! pop DS restore segment registers 
; 
; data has been moved to/from host buffer 

emo wrtype,wtdir write type to directory? 

mov al,ecflag «in case of errors 

inz return Cw «no further orocessina 
; 
: clear host buffer for directory write 

test al,al ¿errors? 

jnz return rw ¿skio if so 

mov hstwrt,0 “buffer written 

call writenst 

mov al,erflag 
return cw: 

ret 
QUEAATEXERELEATEREREREETERERERTERARE AE E A HE Hm 
:* * 
.* WRITEBST performs the physical write to the host * 
;* disk, while READEST reads the ohvsical disk. * 
a Y * 
F 


=. 
f 


ee eee EE RRERREEERERE TERE m end d d doe 


writehst: 

ret 
i 
readhst: 

ret 
; 
SRE E AREER ERATE ERE ERATE ESHER ERSTE EELS SERS SSE 
« Y * 
, 
.* Use the GENDEF utility to create disk def tables * 
>. * 
skoot Ke hA YE YARN ii 
énbase equ offset S 


I 


disk parameter tables go here 


CERRAR dd dd ded dede ede d RR d HR eR Eo e o 
" * 


* Tninitialized RAM areas follow, including the = 
* areas created 5v the GENDEF utility listed above. * 
* 


2 


ede eee ERE AERA n dd Rd dem eere eem 


ex dsk r5 i «seek disk number 
ek trk fw + seek track number 
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326: sek sec Tb l ¿seek sector number 
327: ; 
328: hst dsk rb i :host disk number 
329: hst tzk rw 1 ¿host track number 
230: hst sec rb 1 ¿host sector number 
331: ; 
332: sek_hst rb i ¡seek shr secshf 
333: hst act rb l rhost active flag 
334: hst wrt r5 l shost written flag 
335: 3 
336: una cnt rb i «unalloc rec cnt 
337: una disk r5 l ;last unalloc disk 
338: una_trk rw l «last unalloc track 
* 3391 una sec rb l slast unalloc sector 


340: ; 

341: erflag rb l error reporting 

342: rsflag rb 1 read sector flag 
343: readoo rd l :1 if read overation 
344: wrtvpe rb E ¡write operation tvoe 
345: dma seg rw l ;last dma segment 
346: dma off rw 1 slast dma offset 

347: hstbuf rb hstsiz host buffer 

348: end 
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